Build and Run

On this page

MatchBox supports a quick interpreter loop and multiple deployment targets. Start by running a source file, then select a build based on the target host.

Run a BoxLang script

function greet(name) {
    return "Hello, #name#!";
}

println(greet("world"));
matchbox hello.bxs

Use the REPL

Run matchbox without a filename to start an interactive session. The prompt is bx>, each line is evaluated on its own (there is no multi-line mode, history or tab completion), and exit, quit or Ctrl+D leaves it.

Build for a target

matchbox --build hello.bxs          # portable bytecode: Compiled to hello.bxb
matchbox --target native hello.bxs  # native executable: Native binary produced: hello
matchbox --target js hello.bxs      # ES module + WebAssembly runtime for browsers

WASI targets are experimental. Cross-compilation with --target <rust-triple> needs an embedded runner for that platform. See the CLI reference and target guides, and test each artifact on its destination.

Edit this page Download Markdown Last updated Oct 27, 2026, 1:45:34 PM Report an issue