boxlang-runtime-compiled-native-binarieslisted
Install: claude install-skill ortus-boxlang/skills
# BoxLang Compiled Native Binaries
## Overview
MatchBox can compile BoxLang source code to standalone native executables using `--target native`. The resulting binary embeds a small Rust runner stub (~500 KB) with the compiled BoxLang bytecode appended, requiring no JVM or MatchBox installation on the target machine.
---
## Building a Native Binary
```bash
# Compile script to a native executable (same OS/arch as build machine)
matchbox --target native app.bxs
# Output: ./app (or app.exe on Windows)
# Run it
./app --config=prod.json --debug
```
The binary accepts the same CLI argument format as the `matchbox` runner.
---
## Cross-Compilation
Build for multiple platforms using GitHub Actions (recommended) or the `cross` Rust tool:
### GitHub Actions (5 targets in parallel)
```yaml
# .github/workflows/release.yml
name: Build Native Binaries
on:
push:
tags: ["v*"]
jobs:
build:
strategy:
matrix:
include:
- os: ubuntu-latest
target: x86_64-unknown-linux-gnu
artifact: app-linux-x64
- os: ubuntu-latest
target: aarch64-unknown-linux-gnu
artifact: app-linux-arm64
- os: macos-latest
target: x86_64-apple-darwin
artifact: app-macos-x64
- os: macos-latest
target: aarch64-apple-darwin
artifact: app-macos-arm64
- os: windows-latest
target: x86_64-pc-windows-msvc
artifact: app-windows-