Two top-level sections — pick the one that matches what you're doing.
Start here if you're packaging a Python / PHP / Node app.
- Getting started — install + first bundle.
- Quick start — minimal walkthrough.
- CLI reference — every flag, what it does.
- Examples — Laravel, Flask, Express, GUI apps, etc.
- Architecture overview — how a bundle is laid out and what runs at startup.
- Troubleshooting — common errors and fixes.
- Guides — debug-mode usage, project instructions.
- Bundle test harness — end-to-end validation tests you can run.
Read these if you're modifying ubuilder's source, fixing a bug, or planning a feature.
- Architecture audit — engineering review of the path to true zero-dependency executables.
- Config file spec —
ubuilder.jsonschema, discovery, CLI/config precedence. - Static launcher (S8) — building with
-DUBUILDER_STATIC=ONand the musl toolchain. - Hermetic interpreters (M1) — vendoring strategy,
--runtime-source, Tier-3 isolation. - User dependency install (M8) — staging the runtime, installing user deps without polluting the shared cache.
- Roadmap — what's planned next.
- Release process — how to cut a release.
- Historical reports — snapshots from earlier milestones (kept for reference; not load-bearing).