Getting Started

Three ways to a running application.

Each one ends with a SvelteKit project on the smrt-start template, with the s-m-r-t packages installed. Pick by how you want to begin.

Start from a cookbook

A cookbook is a JSON file naming the recipes an application is made of. build-a-boilerplate exports one. The smrt CLI ships four of its own: bakery, mechanic, welder and yoga-studio.

smrt cookbook apply copies the smrt-start template, adds the packages the recipes need, pins every s-m-r-t package to the CLI's own release (0.57.40), and writes the cookbook to smrt.cookbook.json. Nothing else changes, and no sample data is created. You need Node 26 or newer, git and pnpm 11; no account or token.

terminal

bash

npx -y @happyvertical/smrt-cli@0.57.40 cookbook validate my.cookbook.json
npx -y @happyvertical/smrt-cli@0.57.40 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 has no name of its own, so give the directory. 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.57.40 cookbook apply \
  https://raw.githubusercontent.com/happyvertical/smrt/v0.57.40/packages/cli/cookbooks/bakery.cookbook.json \
  bakery

--dry-run prints what apply would do without writing anything.
--into my-app applies an edited cookbook to an existing project. Edit the cookbook and re-apply; do not 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 that claims it.