@brust/create-app 0.0.0-stage → 2.0.0-alpha.10

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @brust/create-app
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Scaffold a [brust](https://github.com/AssetsArt/brust) v2 app.
+
+```bash
+bun create @brust/app my-app      # --template blank (default) | pokedex
+cd my-app && bun install
+bun run dev                       # http://127.0.0.1:1337
+```
+
+| Option | Meaning |
+|---|---|
+| `--template blank\|pokedex` | The starting point (default `blank`; a terminal asks when omitted). |
+| `--dir <path>` | Target directory (default `./<name>`; it must be empty). |
+| `--yes` | Accept defaults, never prompt. |
+| `--brust-dep <spec>` | The `@brust/core` spec to write (CI and tarball tests). |
+
+`bun create` rejects `-t` and `-y`; use the long flags (the short ones work with `bunx @brust/create-app`).
+
+Full guide: [docs/create-app.md](https://github.com/AssetsArt/brust/blob/main/docs/create-app.md).

package/bin/create-app.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env bun
+// `bun create @brust/app <name> …` runs this bin (bunx @brust/create-app) with the remaining argv.
+import { main } from '../src/cli.ts'
+await main(process.argv.slice(2))

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@brust/create-app",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0-alpha.10",
+  "description": "Scaffold a brust v2 app — bun create @brust/app <name>",
+  "license": "MIT",
+  "homepage": "https://brust.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AssetsArt/brust.git",
+    "directory": "packages/create-app"
+  },
+  "bugs": {
+    "url": "https://github.com/AssetsArt/brust/issues"
+  },
+  "type": "module",
+  "bin": {
+    "create-app": "./bin/create-app.ts"
+  },
+  "files": ["bin", "src", "templates", "README.md"],
+  "scripts": {
+    "build": "bun scripts/sync-template.ts",
+    "prepack": "bun scripts/sync-template.ts",
+    "test": "bun test",
+    "typecheck": "bun check"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.0",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/args.ts

@@ -0,0 +1,64 @@
+// Argument parsing — a port of 0.1.x `brust new` (runtime/cli/new.ts:12-69).
+// Note: `bun create` itself rejects the short flags -t and -y before this bin runs; they work under `bunx @brust/create-app`.
+import { isAbsolute, resolve } from 'node:path'
+
+const NAME_RE = /^[a-z0-9][a-z0-9_-]*$/
+const MAX_NAME_LEN = 50
+
+export const USAGE = 'usage: bun create @brust/app <name> [--template blank|pokedex] [--tailwind] [--dir <path>] [--yes] [--brust-dep <spec>] [--version]'
+
+export interface ParsedArgs {
+  projectName: string
+  targetDir: string
+  template?: string
+  yes: boolean
+  brustDep?: string
+  /** `--tailwind` (L21): accepted and ignored since L28: the blank template uses Tailwind CSS v4 by default. */
+  tailwind: boolean
+  help: boolean
+  /** `--version` (F131): print the bare version and exit; no short form (see the note above). */
+  version: boolean
+}
+
+export function parseArgs(args: string[]): ParsedArgs {
+  let name: string | undefined
+  let dir: string | undefined
+  let template: string | undefined
+  let brustDep: string | undefined
+  let yes = false
+  let tailwind = false
+  let help = false
+  let version = false
+  const need = (flag: string, v: string | undefined): string => {
+    if (!v) throw new Error(`create-app: ${flag} requires a value`)
+    return v
+  }
+
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]!
+    if (a === '--') continue
+    if (a === '--help' || a === '-h') help = true
+    else if (a === '--version') version = true
+    else if (a === '--dir') dir = need('--dir', args[++i])
+    else if (a.startsWith('--dir=')) dir = need('--dir', a.slice('--dir='.length))
+    else if (a === '--template' || a === '-t') template = need('--template', args[++i])
+    else if (a.startsWith('--template=')) template = need('--template', a.slice('--template='.length))
+    else if (a === '--brust-dep') brustDep = need('--brust-dep', args[++i])
+    else if (a.startsWith('--brust-dep=')) brustDep = need('--brust-dep', a.slice('--brust-dep='.length))
+    else if (a === '--yes' || a === '-y') yes = true
+    else if (a === '--tailwind') tailwind = true
+    else if (a.startsWith('-')) throw new Error(`create-app: unknown flag "${a}"`)
+    else if (name === undefined) name = a
+    else throw new Error(`create-app: unexpected positional argument "${a}"`)
+  }
+
+  if (help || version) return { projectName: name ?? '', targetDir: '', template, yes, brustDep, tailwind, help, version }
+  if (!name) throw new Error(`create-app: missing project name. ${USAGE}`)
+  if (name.length > MAX_NAME_LEN) throw new Error(`create-app: project name too long (max ${MAX_NAME_LEN} chars)`)
+  if (!NAME_RE.test(name)) {
+    throw new Error(`create-app: invalid project name "${name}" — use lowercase letters, digits, hyphens, underscores; must start with a letter or digit`)
+  }
+  const cwd = process.cwd()
+  const targetDir = dir ? (isAbsolute(dir) ? dir : resolve(cwd, dir)) : resolve(cwd, name)
+  return { projectName: name, targetDir, template, yes, brustDep, tailwind, help, version }
+}

package/src/cli.ts

@@ -0,0 +1,69 @@
+// `create-app` main — a port of 0.1.x runNew (runtime/cli/new.ts:221-294) with the v2 dependency resolution.
+import { existsSync, readFileSync } from 'node:fs'
+import { readdir, rm } from 'node:fs/promises'
+import { copyTemplate } from './copy.ts'
+import { parseArgs, USAGE } from './args.ts'
+import { applyOverrides, monorepoRoot, resolveBrustDep } from './dep.ts'
+import { TAILWIND_DEFAULT_NOTE } from './tailwind.ts'
+import { selectTemplate } from './templates.ts'
+
+// F131: read at run time from the package.json that `bun publish` ships, so release-bump.ts stays the only place versions change.
+const ownVersion = (): string => (JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as { version?: string }).version ?? '0.0.0'
+
+const fail = (msg: string): never => {
+  console.error(msg)
+  process.exit(1)
+}
+const msg = (e: unknown): string => (e instanceof Error ? e.message : String(e))
+
+export async function main(argv: string[]): Promise<void> {
+  let parsed: ReturnType<typeof parseArgs>
+  try { parsed = parseArgs(argv) } catch (e) { return fail(msg(e)) }
+  if (parsed.help) {
+    console.log(USAGE)
+    return
+  }
+  if (parsed.version) {
+    console.log(ownVersion())
+    return
+  }
+  console.log(`@brust/create-app ${ownVersion()}\n`)
+  const { projectName, targetDir } = parsed
+
+  const targetExisted = existsSync(targetDir)
+  if (targetExisted && (await readdir(targetDir)).length > 0) return fail(`create-app: target directory "${targetDir}" is not empty`)
+
+  let tmpl: ReturnType<typeof selectTemplate>
+  try { tmpl = selectTemplate({ explicit: parsed.template, yes: parsed.yes, isTTY: Boolean(process.stdin.isTTY) }) } catch (e) { return fail(msg(e)) }
+  // L28 R29.1: Tailwind is the blank template's default; the flag stays accepted so older instructions still work.
+  if (parsed.tailwind) console.log(TAILWIND_DEFAULT_NOTE)
+  const dep = resolveBrustDep({ explicit: parsed.brustDep, targetDir })
+
+  try {
+    // R5: from a brust checkout the generated template is rebuilt first, so a developer never copies a stale one.
+    if (tmpl.generated && monorepoRoot() && !process.env.CREATE_APP_TEMPLATES_DIR) {
+      const { syncTemplate } = await import('../scripts/sync-template.ts')
+      syncTemplate()
+    }
+    await copyTemplate({
+      templateDir: tmpl.dir,
+      targetDir,
+      substitutions: { __PROJECT_NAME__: projectName, __BRUST_DEP__: JSON.stringify(dep.spec) },
+    })
+    if (dep.overrides) applyOverrides(targetDir, dep.overrides)
+  } catch (e) {
+    if (!targetExisted) await rm(targetDir, { recursive: true, force: true }).catch(() => {})
+    return fail(`create-app: failed to scaffold (${msg(e)})`)
+  }
+  printNextSteps(projectName, targetDir, tmpl.name, dep.spec, dep.kind === 'workspace')
+}
+
+function printNextSteps(name: string, targetDir: string, template: string, spec: string, workspace: boolean): void {
+  const cwd = process.cwd()
+  const displayPath = targetDir.startsWith(`${cwd}/`) ? `./${targetDir.slice(cwd.length + 1)}` : targetDir
+  console.log(`Created ${name} at ${targetDir} (template: ${template}, @brust/core ${spec})\n`)
+  console.log('Next:')
+  console.log(`  cd ${displayPath}`)
+  console.log(workspace ? '  bun install   # run it at the brust repo root: this app is a workspace member' : '  bun install')
+  console.log('  bun run dev')
+}

package/src/copy.ts

@@ -0,0 +1,44 @@
+// copyTemplate — a port of 0.1.x runtime/cli/new.ts:100-163. `*.tmpl` files are substituted and lose the suffix, `_gitignore`
+// becomes `.gitignore` (npm silently drops a nested .gitignore from a tarball), everything else is copied byte-for-byte.
+// Symlinks are skipped, as in 0.1.x.
+import { existsSync } from 'node:fs'
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+export interface CopyTemplateOpts {
+  templateDir: string
+  targetDir: string
+  substitutions: Record<string, string>
+}
+
+export async function copyTemplate(opts: CopyTemplateOpts): Promise<void> {
+  if (!existsSync(opts.templateDir)) {
+    throw new Error(`create-app: template directory not found at ${opts.templateDir}; this is a @brust/create-app installation bug`)
+  }
+  await copyDir(opts.templateDir, opts.targetDir, opts.substitutions)
+}
+
+async function copyDir(src: string, dst: string, subs: Record<string, string>): Promise<void> {
+  await mkdir(dst, { recursive: true })
+  for (const ent of await readdir(src, { withFileTypes: true })) {
+    const srcPath = join(src, ent.name)
+    const dstPath = join(dst, renameForEmit(ent.name))
+    if (ent.isDirectory()) await copyDir(srcPath, dstPath, subs)
+    else if (ent.isFile()) {
+      if (ent.name.endsWith('.tmpl')) await writeFile(dstPath, applySubstitutions(await readFile(srcPath, 'utf8'), subs))
+      else await writeFile(dstPath, await readFile(srcPath))
+    }
+  }
+}
+
+function renameForEmit(name: string): string {
+  if (name.endsWith('.tmpl')) return name.slice(0, -'.tmpl'.length)
+  if (name === '_gitignore') return '.gitignore'
+  return name
+}
+
+function applySubstitutions(text: string, subs: Record<string, string>): string {
+  let out = text
+  for (const [key, value] of Object.entries(subs)) out = out.split(key).join(value)
+  return out
+}

package/src/dep.ts

@@ -0,0 +1,61 @@
+// Resolves the `@brust/core` spec written into a scaffolded package.json (`__BRUST_DEP__`, M3-F rulings R2/R3).
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join, relative, resolve } from 'node:path'
+
+/** = scripts/release-files.ts PLATS. */
+export const PLATS = ['darwin-x64', 'darwin-arm64', 'linux-x64-gnu', 'linux-arm64-gnu', 'linux-x64-musl', 'linux-arm64-musl'] as const
+
+export interface BrustDep {
+  kind: 'explicit' | 'version' | 'workspace' | 'file'
+  spec: string
+  overrides?: Record<string, string>
+}
+
+export const packageRoot = (): string => resolve(import.meta.dir, '..')
+
+const readJson = (p: string): Record<string, unknown> | null => {
+  try { return JSON.parse(readFileSync(p, 'utf8')) as Record<string, unknown> } catch { return null }
+}
+
+/** The brust checkout this package lives in, or null. Exact markers two levels up, no walking: a bunx cache can never match. */
+export function monorepoRoot(pkgRoot = packageRoot()): string | null {
+  const root = resolve(pkgRoot, '../..')
+  const rootPkg = readJson(join(root, 'package.json'))
+  if (rootPkg?.name !== 'brust-v2' || !Array.isArray(rootPkg.workspaces)) return null
+  if (readJson(join(root, 'packages/brust/package.json'))?.name !== '@brust/core') return null
+  if (!existsSync(join(root, 'examples/pokedex/routes.tsx'))) return null
+  return root
+}
+
+/** `x/*` matches a direct child of `<root>/x`; a literal `x` matches `<root>/x` itself. */
+function inWorkspace(root: string, target: string): boolean {
+  const rootPkg = readJson(join(root, 'package.json'))
+  const globs = (rootPkg?.workspaces as string[] | undefined) ?? []
+  const rel = relative(root, resolve(target))
+  if (rel.startsWith('..') || rel === '') return false
+  return globs.some((g) => (g.endsWith('/*') ? dirname(rel) === g.slice(0, -2) : rel === g))
+}
+
+export function resolveBrustDep(o: { explicit?: string; targetDir: string; pkgRoot?: string }): BrustDep {
+  if (o.explicit) return { kind: 'explicit', spec: o.explicit }
+  const pkgRoot = o.pkgRoot ?? packageRoot()
+  const root = monorepoRoot(pkgRoot)
+  if (root) {
+    if (inWorkspace(root, o.targetDir)) return { kind: 'workspace', spec: 'workspace:*' }
+    // `file:` alone fails: core's own workspace:* deps do not resolve outside the workspace globs, so override them.
+    const overrides: Record<string, string> = { '@brust/runtime-dom': `file:${root}/packages/runtime-dom` }
+    overrides['@brust/core-cf'] = `file:${root}/npm/core-cf`
+    for (const p of PLATS) overrides[`@brust/native-${p}`] = `file:${root}/npm/${p}`
+    return { kind: 'file', spec: `file:${root}/packages/brust`, overrides }
+  }
+  const version = (readJson(join(pkgRoot, 'package.json'))?.version as string | undefined) ?? '0.0.0'
+  return { kind: 'version', spec: `^${version}` }
+}
+
+/** Merge `overrides` into <appDir>/package.json (2-space JSON + trailing newline). */
+export function applyOverrides(appDir: string, overrides: Record<string, string>): void {
+  const p = join(appDir, 'package.json')
+  const pkg = JSON.parse(readFileSync(p, 'utf8')) as Record<string, unknown>
+  pkg.overrides = { ...(pkg.overrides as Record<string, string> | undefined), ...overrides }
+  writeFileSync(p, `${JSON.stringify(pkg, null, 2)}\n`)
+}

package/src/tailwind.ts

@@ -0,0 +1,10 @@
+// Tailwind CSS v4 in the blank template (gaps round L21, made the default by L28 R29.1): the template ships `app.css`
+// (`@import "tailwindcss"` + `@theme` tokens), the layout imports it (brust builds it and links it in <head>, L19), and
+// the pinned dev dependencies below are in its package.json (R21.1: the app's own; L32 R33.2: the compiler, its Node API
+// and the scanner, one exact version, so the build compiles with the tailwindcss the app pinned). `--tailwind` no longer
+// changes anything; it prints TAILWIND_DEFAULT_NOTE.
+
+/** The exact versions brust's own tests build with (the blank template's package.json pins the same). */
+export const TAILWIND_DEV_DEPS = { '@tailwindcss/node': '4.3.3', '@tailwindcss/oxide': '4.3.3', tailwindcss: '4.3.3' }
+
+export const TAILWIND_DEFAULT_NOTE = 'create-app: Tailwind CSS v4 is the default; the --tailwind flag does nothing'

package/src/templates.ts

@@ -0,0 +1,64 @@
+// Template registry + selection (port of 0.1.x new.ts:165-220). `blank` is committed; `pokedex` is GENERATED from
+// examples/pokedex by scripts/sync-template.ts (prepack, monorepo runs, tests) and gitignored.
+import { join, resolve } from 'node:path'
+
+export interface TemplateDef {
+  name: string
+  description: string
+  dir: string
+  /** true → produced by scripts/sync-template.ts, never hand-edited. */
+  generated: boolean
+}
+
+export const DEFAULT_TEMPLATE = 'blank'
+
+/** Test-only hook: point both templates at another directory (CREATE_APP_TEMPLATES_DIR) to exercise the copy-failure rollback. */
+const templatesDir = (): string => process.env.CREATE_APP_TEMPLATES_DIR || resolve(import.meta.dir, '../templates')
+
+export function listTemplates(): TemplateDef[] {
+  const root = templatesDir()
+  return [
+    { name: 'blank', description: 'One page, a native counter, an Elysia hello action', dir: join(root, 'blank'), generated: false },
+    { name: 'pokedex', description: 'The v2 Pokédex: loaders, L1 cache, native + island, the team store on Elysia actions + SQLite', dir: join(root, 'pokedex'), generated: true },
+  ]
+}
+
+export interface SelectTemplateOpts {
+  explicit?: string
+  yes: boolean
+  isTTY: boolean
+  read?: (label: string) => string | null
+  print?: (s: string) => void
+}
+
+export function selectTemplate(opts: SelectTemplateOpts): TemplateDef {
+  const templates = listTemplates()
+  if (opts.explicit !== undefined) {
+    const t = templates.find((x) => x.name === opts.explicit)
+    if (!t) throw new Error(`create-app: unknown template "${opts.explicit}" — choose one of: ${templates.map((x) => x.name).join(', ')}`)
+    return t
+  }
+  if (opts.yes || !opts.isTTY) return templates.find((t) => t.name === DEFAULT_TEMPLATE) ?? templates[0]!
+  const read = opts.read ?? ((label: string) => prompt(label))
+  const print = opts.print ?? ((s: string) => process.stdout.write(s))
+  return promptPicker(templates, read, print)
+}
+
+function promptPicker(templates: TemplateDef[], read: (label: string) => string | null, print: (s: string) => void): TemplateDef {
+  const def = templates.find((t) => t.name === DEFAULT_TEMPLATE) ?? templates[0]!
+  const defIndex = templates.indexOf(def) + 1
+  for (let attempt = 0; attempt < 3; attempt++) {
+    print('Select a template:\n')
+    for (let i = 0; i < templates.length; i++) print(`  ${i + 1}) ${templates[i]!.name} — ${templates[i]!.description}\n`)
+    const raw = read(`Template [${defIndex}]: `)
+    if (raw === null) return def
+    const input = raw.trim()
+    if (input === '') return def
+    const asNum = Number.parseInt(input, 10)
+    if (!Number.isNaN(asNum) && asNum >= 1 && asNum <= templates.length) return templates[asNum - 1]!
+    const byName = templates.find((t) => t.name === input)
+    if (byName) return byName
+    print(`Invalid selection "${input}". Try again.\n`)
+  }
+  return def
+}

package/templates/blank/README.md.tmpl

@@ -0,0 +1,43 @@
+# __PROJECT_NAME__
+
+A [brust](https://github.com/AssetsArt/brust) app: React components compiled ahead of time, served by Rust.
+
+## Run
+
+```bash
+bun install
+bun run dev        # brust dev routes.tsx (hot reload)  ->  http://127.0.0.1:1337
+```
+
+Scripts: `dev` (`brust dev`, with hot reload), `build`, `start`, `typecheck`, `dev:cf` (build for Cloudflare Workers and run `wrangler dev`), `deploy:cf` (build and `wrangler deploy`).
+
+## Layout
+
+- `routes.tsx` — `defineRoutes`: one layout, one page.
+- `components/Layout.tsx` — the document root (`<html>` + `<Outlet/>`).
+- `components/Counter.tsx` — a `useState` counter; the compiler makes it a native component (no React in the browser).
+- `actions.ts` — an Elysia 2 app on `brust()`, served by Rust under `/_brust/action` (enabled by `[actions]` in `brust.toml`).
+- `public/` — static files, served at `/public/...`.
+- `wrangler.jsonc` — your Cloudflare bindings (D1, KV, vars); brust owns `main`, `assets` and `compatibility_date`.
+
+## The hello action
+
+```bash
+curl 'http://127.0.0.1:1337/_brust/action/hello?name=ash'
+# {"message":"Hello, ash!"}
+```
+
+From the browser, use the typed client:
+
+```ts
+import { client } from '@brust/core/client'
+import type { App } from './actions'
+
+const api = client<App>()
+const { data } = await api.hello.get({ query: { name: 'ash' } })
+```
+
+## Docs
+
+- Actions: https://github.com/AssetsArt/brust/blob/main/docs/actions.md
+- The unified store: https://github.com/AssetsArt/brust/blob/main/docs/store.md

package/templates/blank/_gitignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+.brust/
+.wrangler/

package/templates/blank/actions.ts

@@ -0,0 +1,13 @@
+import { brust } from '@brust/core/elysia'
+import { Elysia, t } from 'elysia'
+
+// One Elysia 2 app, served by the Rust server under /_brust/action (brust.toml [actions]).
+// Elysia 2 takes (path, hook, handler). Never call app.listen(): Rust owns HTTP.
+const app = new Elysia({ adapter: brust() }).get(
+  '/hello',
+  { query: t.Object({ name: t.Optional(t.String()) }) },
+  ({ query }) => ({ message: `Hello, ${query.name ?? 'world'}!` }),
+)
+
+export default app
+export type App = typeof app

package/templates/blank/app.css

@@ -0,0 +1,32 @@
+@import "tailwindcss";
+
+/* Tailwind CSS v4, CSS-first: no tailwind.config. The tokens below are the brust docs palette; each one becomes a
+   utility (bg-paper, text-ink, border-rule, ...). A *.module.css that uses @apply starts with
+   @reference "../app.css"; (see brust docs/css.md). */
+@theme {
+  --color-paper: oklch(94% 0.035 78);
+  --color-sheet: oklch(97% 0.02 82);
+  --color-ink: oklch(18% 0.035 82);
+  --color-ink-2: oklch(36% 0.045 80);
+  --color-rule: oklch(76% 0.05 77);
+  --color-amber: oklch(68% 0.145 74);
+  --color-amber-ink: oklch(46% 0.12 62);
+  --font-sans: ui-rounded, "SF Pro Rounded", system-ui, sans-serif;
+}
+
+/* Dark mode follows the system: the same tokens, darker values, so every utility switches with them. */
+@media (prefers-color-scheme: dark) {
+  :root {
+    --color-paper: oklch(20% 0.028 185);
+    --color-sheet: oklch(24% 0.032 182);
+    --color-ink: oklch(91% 0.02 82);
+    --color-ink-2: oklch(77% 0.03 82);
+    --color-rule: oklch(36% 0.032 180);
+    --color-amber: oklch(74% 0.12 78);
+    --color-amber-ink: oklch(81% 0.11 80);
+  }
+}
+
+:root {
+  color-scheme: light dark;
+}

package/templates/blank/brust.toml

@@ -0,0 +1,6 @@
+[server]
+address = "127.0.0.1"
+port = 1337
+
+# Elysia actions (docs/actions.md). Defaults: entry = "actions.ts", prefix = "/_brust/action", max_body_bytes = 1048576, max_response_bytes = 8388608
+[actions]

package/templates/blank/components/Counter.tsx

@@ -0,0 +1,15 @@
+// useState only, so the compiler lowers this to a native component: a signal in the browser, no React shipped.
+import { useState } from 'react'
+
+export default function Counter() {
+  const [count, setCount] = useState(0)
+  return (
+    <button
+      type="button"
+      className="cursor-pointer rounded-[0.6rem] border border-amber-ink bg-amber px-[1.1rem] py-2 font-semibold text-[oklch(18%_0.035_82)] hover:brightness-106 focus-visible:outline-3 focus-visible:outline-offset-3 focus-visible:outline-amber-ink"
+      onClick={() => setCount(count + 1)}
+    >
+      count is {count}
+    </button>
+  )
+}

package/templates/blank/components/Layout.tsx

@@ -0,0 +1,22 @@
+// The document root: a plain <html> with <Outlet/> for the page. app.css (Tailwind CSS v4) is imported here; brust
+// builds it into one hashed file and links it in <head>. Static files are served from /public.
+import { Outlet } from '@brust/core/routes'
+import '../app.css'
+
+export default function Layout() {
+  return (
+    <html lang="en">
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <title>brust app</title>
+        <link rel="icon" href="/public/favicon.svg" />
+      </head>
+      <body className="bg-paper font-sans text-ink leading-[1.55]">
+        <main className="mx-auto box-border max-w-2xl px-4 py-16">
+          <Outlet />
+        </main>
+      </body>
+    </html>
+  )
+}

package/templates/blank/package.json.tmpl

@@ -0,0 +1,30 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "brust dev routes.tsx",
+    "build": "brust build routes.tsx",
+    "start": "brust start",
+    "typecheck": "bun check",
+    "dev:cf": "brust dev routes.tsx --target cloudflare",
+    "deploy:cf": "brust build routes.tsx --target cloudflare && wrangler deploy -c dist/cf/wrangler.jsonc"
+  },
+  "dependencies": {
+    "@brust/core": __BRUST_DEP__,
+    "@elysia/eden": "2.0.0-beta.6",
+    "elysia": "2.0.0-beta.30",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/node": "4.3.3",
+    "@tailwindcss/oxide": "4.3.3",
+    "@types/bun": "^1.4.0",
+    "@types/react": "^19.2.0",
+    "tailwindcss": "4.3.3",
+    "typescript": "^7.0.2",
+    "wrangler": "^4.149.0"
+  }
+}

package/templates/blank/pages/HomePage.tsx

@@ -0,0 +1,35 @@
+import Counter from '../components/Counter'
+
+const link = 'font-semibold text-amber-ink underline underline-offset-[0.2em] hover:decoration-2 focus-visible:rounded focus-visible:outline-3 focus-visible:outline-offset-3 focus-visible:outline-amber-ink'
+
+export default function HomePage() {
+  return (
+    <>
+      <header className="flex items-center gap-[0.9rem]">
+        <svg className="flex-none" viewBox="0 0 32 32" width="44" height="44" aria-hidden="true">
+          <rect width="32" height="32" rx="8" fill="#062323" />
+          <path d="M7 19a9 9 0 0 1 18 0z" fill="#f2a516" />
+          <rect x="5" y="20.5" width="22" height="2.2" rx="1.1" fill="#f2a516" />
+          <rect x="10" y="24.6" width="12" height="2" rx="1" fill="#f2a516" opacity=".55" />
+        </svg>
+        <h1 className="m-0 text-4xl leading-[1.1] font-bold tracking-[-0.01em]">brust app</h1>
+      </header>
+      <p className="mt-4 mb-8 text-lg text-ink-2">Edit pages/HomePage.tsx and save. The page reloads.</p>
+      <section className="rounded-2xl border border-rule bg-sheet p-6">
+        <Counter />
+        <p className="mt-4 mb-0 text-[0.9375rem] text-ink-2">useState only, so this button is native: a signal in the browser, no React shipped.</p>
+      </section>
+      <nav className="mt-8 flex flex-wrap gap-x-6 gap-y-2" aria-label="Learn more">
+        <a className={link} href="https://brust.dev">
+          Docs
+        </a>
+        <a className={link} href="https://brust.dev/docs/routing">
+          Routes
+        </a>
+        <a className={link} href="https://brust.dev/docs/actions">
+          Actions
+        </a>
+      </nav>
+    </>
+  )
+}

package/templates/blank/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="8" fill="#062323"/><path d="M7 19a9 9 0 0 1 18 0z" fill="#f2a516"/><rect x="5" y="20.5" width="22" height="2.2" rx="1.1" fill="#f2a516"/><rect x="10" y="24.6" width="12" height="2" rx="1" fill="#f2a516" opacity=".55"/></svg>

package/templates/blank/routes.tsx

@@ -0,0 +1,5 @@
+import { defineRoutes } from '@brust/core/routes'
+import Layout from './components/Layout'
+import HomePage from './pages/HomePage'
+
+export const routes = defineRoutes([{ Component: Layout, children: [{ path: '/', Component: HomePage }] }])

package/templates/blank/tsconfig.json

@@ -0,0 +1,37 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": [
+      "ESNext",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "types": [
+      "bun"
+    ],
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  },
+  "exclude": [
+    "dist",
+    "node_modules"
+  ]
+}