norns-demo

The reference app — notes on Cloudflare D1, tic-tac-toe with stores, the norns-ui showcase, each example also written in vanilla SvelteKit for comparison.

git clone https://github.com/human-synthesis/norns-demo
cd norns-demo
bun install
bun run db:migrate   # apply migrations to the local D1 under .wrangler/state/
bun run dev          # http://localhost:5173

The dev server gets event.platform.env.DB from adapter-cloudflare's platform proxy, which reads wrangler.toml and keeps a local D1 under .wrangler/state/. No Cloudflare account is needed to run locally. Production runs at norns-demo.humansynthesis.ai.

#What it shows

Notes — D1, dynamic routes, form actions, valibot, error pages, SSR load, the DI container, the facade boundary, the page wrappers, and a TRON endpoint in schema mode.
Tic-tac-toe — multi-component composition, $props with defaults, Svelte stores, $state / $effect, scoped CSS and a small AI heuristic.
UI showcase — every norns-ui component with live props.
Deploy — the Workers + D1 setup and the GitHub Actions workflow.

Each example exists twice, once in Norns (src/routes/examples/norns/, src/lib/norns/) and once in vanilla SvelteKit (src/routes/examples/svelte/, src/lib/svelte/), so the two can be compared line for line. Do not "convert" the vanilla side; it is the control group.

#Commands

bun run lint             # norns lint
bun run check            # norns check — every .n / .c / .svelte through svelte.config.js
bun run check:svelte     # svelte-check over the vanilla .svelte / .ts side
bun run build
bun run migrate create notes/<name>      # scaffold a migration (norns CLI)
bun run db:migrate / db:migrate:remote   # apply with wrangler, local / production

The repo has no test suite of its own; it is exercised through the dev server and the build.