@nbt-dev/nbt

The nbt CLI and console daemon for the nbt-dev console — a fixed-target platform for web development.

Install

npm i -g @nbt-dev/nbt

Workflow

npx @nbt-dev/nbt init my-app         # scaffold a new project; vendors core auth into nbt/auth
npx nbt list                         # list available standard modules
npx nbt add crm email                # vendor standard cartridges into nbt/
npx nbt update crm email             # refresh vendored modules without deleting migrations
# ...edit nbt/<cart>/schema.nbt (entities, indexes, @route decls)…
npx nbt dev                          # boot the console + live-reload local carts on save
npx nbt migrate create billing --baseline # first migration from the schema
npx nbt generate                     # typed TS clients for the local cartridge set

npx nbt migrate deploy               # upload local source + apply migrations
npx nbt migrate deploy --env prod    # target another configured environment

Commands read nbt.json for paths and the target instance; --host/--port/--root/--out flags override it. Run from anywhere inside the project — nbt walks up to find nbt.json.

Standard cartridges use a shadcn-style ownership model: nbt add <name> copies their source into your configured carts directory. The local copy is visible and editable, nbt generate follows that local cartridge set, and nbt migrate deploy uploads it to the configured console.

npx nbt up                                  # boot using nbt.json dev port
npx nbt up --port 8080 --data-dir ./data    # explicitly override port/data dir
npx nbt up --help                           # daemon boot flags

Run npx nbt --help or npx nbt <command> --help for the full surface.

Platform

linux/x64 only for now. macOS / arm64 are not yet published.