box.json File

This file is in the root directory of every box. It specifies metadata about the it.

Example

{
    "name": "awesome_box",
    "version": "v0.1.0",
    "author": "John Doe",
    "license": "MIT",
    "description": "John Doe's awesome box for doing awesome stuff",
    "readme": "README.md",
    "link": "https://git.sr.ht/~jdoe/awesome_box",
    "dependencies": ["coulau", "umka"],
    "include": ["awesome.um"],
    "run": "umka awesome.um"
}

Options

name

This sets the box's name. It has to match the name specified when registering the box. If it does not match, it will be changed accordingly.

version

Version of the box.

author

Author of the box.

license

Name of the license.

description

Short description of the box.

readme

Path to the box's readme file.

link

Link to the box's homepage or repository.

dependencies

A list of boxes this box depends on.

include

A list of files or directories that shall be packaged with the build.

run

A command used before umbox run arguments are executed.

run_posix

A version of the run command used on POSIX systems.

run_windows

A version of the run command used on Windows systems.

pre_build

A command ran before a build.

post_build

A command ran after a build.