smrt
Open the smrt source on GitHub Switch to dark color scheme

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.

terminal
bash
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 page

A 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.

terminal
bash
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 \
  bakery

No 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.

terminal
bash
npx -y @happyvertical/smrt-cli@0.62.10 kitchen my-app      # opens http://127.0.0.1:<port>/ in the browser
  • --no-open prints the kitchen address instead of opening your browser; --port lets you pick the port.
  • --dry-run prints what apply would do, without writing anything.
  • --into my-app applies an edited cookbook to a project you already have. When you want a change, edit the cookbook and re-apply; don't hand-edit smrt.cookbook.json.
  • pnpm app:setup builds, creates the local database and issues a one-time owner invitation; pnpm app:open opens the page where you claim it.