Internals
Build guide
Build targets, feature flags, testing, and how to assemble the dev environment with bundled binaries.
Targets
Command
Output
make build
~585 KB WASM, no bundled binaries
make test
runs the full suite (24 tests)
make demo
WASM + bundled binaries + Vite dev server
Sizes
- ~585 KB — the core module on its own.
- ~68 MB — with BusyBox, Node.js and the dev environment embedded.
The dev environment
make demo expects images/busybox, images/node and build/devenv.tar.gz. The devenv archive is produced by the Docker build scripts under build/ and contains the npm / TypeScript toolchain.
bash
# produce the bundled binaries + devenv archive # (see build/ for the Docker scripts) make build make demo
Testing
The suite runs MemFS unit tests, ELF execution tests, BusyBox smoke tests and devenv tool tests.
bash
$ make test --- MemFS Unit Tests --- 50 passed --- ELF Execution Tests --- 6 passed --- BusyBox Smoke Tests --- 17 passed --- Devenv Tool Tests --- 6 passed Results: 24 passed, 0 failed