Getting Started
Three ways to a running app.
Whichever you choose, you end up with a SvelteKit project on the smrt-start template, with the smrt packages installed. Pick the one that suits how you like to start.Start from a cookbook
A cookbook is a JSON file that names the recipes your app is made of. build-a-boilerplate exports one for you, and the smrt CLI comes with four of its own: bakery, mechanic, welder and yoga-studio.
smrt cookbook apply copies the smrt-start template, adds the packages your
recipes need, pins every smrt package to the CLI's own release (0.62.10), and writes
the cookbook to smrt.cookbook.json. That's the whole job: nothing else changes,
and it doesn't create any sample data. You'll need Node 26 or newer, git and pnpm 11. You
don't need an account or a token.
npx -y @happyvertical/smrt-cli@0.62.10 cookbook validate my.cookbook.json
npx -y @happyvertical/smrt-cli@0.62.10 cookbook apply my.cookbook.json my-app
cd my-app
pnpm app:setup
pnpm app:doctor
pnpm dev # http://127.0.0.1:5173
pnpm app:open # in a second terminal: the one-time owner setup pageA library cookbook doesn't have a name of its own, so tell it which directory to use. The file can be a path or a URL; this one is the bakery at the release tag.
npx -y @happyvertical/smrt-cli@0.62.10 cookbook apply \
https://raw.githubusercontent.com/happyvertical/smrt/v0.62.10/packages/cli/cookbooks/bakery.cookbook.json \
bakeryNo file yet? smrt kitchen is the same path without one. It serves build-a-boilerplate
on localhost, opens your browser and waits for you. Shape your app there, then choose Send to kitchen:
kitchen validates the cookbook, applies it into the directory and installs the packages. The first
run downloads the planner, about 70 MB, into a local cache.
npx -y @happyvertical/smrt-cli@0.62.10 kitchen my-app # opens http://127.0.0.1:<port>/ in the browser--no-openprints the kitchen address instead of opening your browser;--portlets you pick the port.--dry-runprints what apply would do, without writing anything.--into my-appapplies an edited cookbook to a project you already have. When you want a change, edit the cookbook and re-apply; don't hand-editsmrt.cookbook.json.pnpm app:setupbuilds, creates the local database and issues a one-time owner invitation;pnpm app:openopens the page where you claim it.