Repository & packages
Neutron is a monorepo. npm owns dependency installation and the single lockfile; Bun runs the TypeScript scripts and unit tests, and Motoko dependencies are resolved through Mops.
Package construction, whole-actor compilation, and canister provisioning have separate entrypoints. The provisioner consumes finished archives and calls the compiler; it does not discover or build app workspaces.
| Package | One-line responsibility |
|---|---|
neutron-tools | The shared browser/app SDK: message bus, manifest schema, repository protocol |
neutron-scripts | Packaging: manifest generation, Motoko packing, validation, archive creation |
neutron-compiler | Actor assembly, compilation, and the shared install/deploy helpers |
neutron-cli | A compile-only filesystem adapter over the compiler |
neutron-security | The static Motoko policy — text and AST checks plus fixtures |
neutron-provision | Whole-canister provisioning for IC and supervised PocketIC targets |
neutron-design-system | Scoped dark SCSS and tokens for app frontends |
| Motoko packages | The vendored compiler and the versioned capability leaf types |
Start with Build topology for how they fit together, including the current app and support workspaces, or jump to a package page.