brustjs 0.1.16-alpha → 0.1.18-alpha

package/example/pokedex/pages/DetailPage.tsx

@@ -0,0 +1,167 @@
+// Route "/pokemon/{name}" — NATIVE detail page. Per the decision to push native
+// as far as possible, the evolution chain is loaded BLOCKING in the loader (a
+// native/jinja route has no React tree, so <Suspense> streaming is impossible —
+// see ../FRAMEWORK-GAPS.md S3).
+//
+// Native routes now support conditionals (S11): the page uses a real
+// `{notFound ? <NotFound/> : <Content/>}` branch, `{hasAbilities && …}` /
+// `{hasEvolution && …}` sections, and per-item `{!s.isFirst && <Arrow/>}` /
+// `{s.showLevel && <Level/>}` separators — no more loader-computed hide-classes.
+// The <title> is dynamic via `<BrustPage title={pageTitle}>` (S8) and inline
+// styles use `style={{…}}` objects (S1).
+import { Island } from 'brustjs'
+import AddToTeamButton from '../components/AddToTeamButton'
+import PageLayout from '../components/PageLayout'
+import type { DetailData } from '../lib/types'
+
+export default function DetailPage({
+  notFound,
+  pageTitle,
+  hasAbilities,
+  hasEvolution,
+  displayName,
+  num,
+  artwork,
+  genus,
+  flavorText,
+  heightLabel,
+  weightLabel,
+  abilityCount,
+  heroBg,
+  types,
+  stats,
+  statTotal,
+  abilities,
+  evolution,
+  addProps,
+  teamProps,
+}: DetailData) {
+  return (
+    <PageLayout native title={pageTitle} active="list" crumb={displayName} teamProps={teamProps}>
+      <a className="aa-btn aa-btn--ghost aa-btn--sm dex-back" href="/">
+        ‹ Pokédex
+      </a>
+
+      {notFound ? (
+        <div className="dex-notfound">
+          <div className="dex-notfound__code">404</div>
+          <h2 className="aa-h3">No Pokémon named “{displayName}”</h2>
+          <p className="dex-notfound__desc">
+            loader ได้ 404 จาก PokeAPI. brust ยังไม่มี notFound() sentinel — หน้านี้จึงตอบ HTTP 200 พร้อม
+            body นี้ (ดู FRAMEWORK-GAPS.md S9).
+          </p>
+          <a className="aa-btn" href="/">
+            ‹ Back to Pokédex
+          </a>
+        </div>
+      ) : (
+        <>
+          <div className="dex-detail-grid">
+            <div className="aa-card dex-hero" style={{ background: heroBg }}>
+              <div className="dex-hero__num">{num}</div>
+              <h1 className="dex-hero__name">{displayName}</h1>
+              <div className="dex-hero__genus">{genus}</div>
+              <div className="dex-hero__art">
+                <img src={artwork} alt={displayName} className="dex-hero__img" />
+              </div>
+              <div className="dex-hero__types">
+                {types.map((t) => (
+                  <span key={t.label} className={t.className}>
+                    {t.label}
+                  </span>
+                ))}
+              </div>
+              <Island component={AddToTeamButton} props={addProps} hydrate="load" />
+            </div>
+
+            <div className="dex-detail-right">
+              <div className="aa-card aa-card--padded">
+                <p className="dex-flavor">{flavorText}</p>
+                <div className="dex-measures">
+                  <div className="dex-measure">
+                    <div className="dex-measure__v">{heightLabel}</div>
+                    <div className="dex-measure__k">Height</div>
+                  </div>
+                  <div className="dex-measure">
+                    <div className="dex-measure__v">{weightLabel}</div>
+                    <div className="dex-measure__k">Weight</div>
+                  </div>
+                  <div className="dex-measure">
+                    <div className="dex-measure__v">{abilityCount}</div>
+                    <div className="dex-measure__k">Abilities</div>
+                  </div>
+                </div>
+                {hasAbilities && (
+                  <div className="dex-abilities">
+                    {abilities.map((a) => (
+                      <span key={a.displayName} className="aa-chip">
+                        <span className="aa-chip__icon" style={{ background: a.iconColor }}>
+                          {a.initial}
+                        </span>
+                        {a.displayName}
+                      </span>
+                    ))}
+                  </div>
+                )}
+              </div>
+
+              <div className="aa-section dex-stats">
+                <div className="aa-section__head">
+                  <h2 className="aa-section__title">Base stats</h2>
+                  <span className="dex-stats__total">Σ {statTotal}</span>
+                </div>
+                <div className="aa-section__body dex-stats__body">
+                  {stats.map((st) => (
+                    <div key={st.label} className="dex-statbar">
+                      <span className="dex-statbar__label">{st.label}</span>
+                      <span className="dex-statbar__val">{st.base}</span>
+                      <div className="dex-statbar__track">
+                        <div className={st.barClassName} style={{ width: st.barWidth }} />
+                      </div>
+                    </div>
+                  ))}
+                </div>
+              </div>
+            </div>
+          </div>
+
+          {hasEvolution && (
+            <div className="aa-section dex-evo">
+              <div className="aa-section__head">
+                <div>
+                  <h2 className="aa-section__title">Evolution chain</h2>
+                  <div className="aa-section__desc">
+                    โหลดใน loader (native route stream{' '}
+                    <code className="dex-code">&lt;Suspense&gt;</code> ไม่ได้ — ดู GAPS S3)
+                  </div>
+                </div>
+              </div>
+              <div className="aa-section__body dex-evo__body">
+                {evolution.map((s) => (
+                  <div key={s.id} className="dex-evo__stage">
+                    {!s.isFirst && (
+                      <div className="dex-evo__sep">
+                        <span className="dex-evo__arrow">›</span>
+                        {s.showLevel && <span className="dex-evo__lv">{s.levelLabel}</span>}
+                      </div>
+                    )}
+                    <a className={s.cardClassName} href={s.detailHref}>
+                      <img
+                        className="dex-evo__img"
+                        src={s.artwork}
+                        alt={s.displayName}
+                        loading="lazy"
+                      />
+                      <div className="dex-evo__num">{s.num}</div>
+                      <div className="dex-evo__name">{s.displayName}</div>
+                    </a>
+                  </div>
+                ))}
+              </div>
+            </div>
+          )}
+        </>
+      )}
+    </PageLayout>
+  )
+}

package/example/pokedex/pages/ListPage.tsx

@@ -0,0 +1,83 @@
+// Route "/" — the Pokédex list. NATIVE route: this whole tree is compiled to a
+// minijinja template and rendered in Rust (no React on the server). The only
+// non-host tags are <BrustPage> (the document shell) and <Island> (the floating
+// team dock) — both intercepted by the compiler.
+//
+// Native route components support `.map()` AND conditionals (S11): pagination
+// "disabled" state is a real `{hasPrev ? <a/> : <span/>}` branch, not a
+// precomputed hide-class. See ../FRAMEWORK-GAPS.md S11.
+import PageLayout from '../components/PageLayout'
+import type { ListData } from '../lib/types'
+
+export default function ListPage({
+  items,
+  totalLabel,
+  showingLabel,
+  pageLabel,
+  offsetLabel,
+  hasPrev,
+  hasNext,
+  prevHref,
+  nextHref,
+  teamProps,
+}: ListData) {
+  return (
+    <PageLayout
+      native
+      title="PokéDex · brust example"
+      active="list"
+      crumb="All Pokémon"
+      teamProps={teamProps}
+    >
+      <div className="aa-page-header">
+        <div>
+          <h1 className="aa-page-header__title">Pokédex</h1>
+          <div className="aa-page-header__desc">
+            National Dex · {totalLabel} Pokémon · loader{' '}
+            <code className="dex-code">GET /pokemon?limit=20&offset={offsetLabel}</code>
+          </div>
+        </div>
+      </div>
+
+      <div className="aa-alert aa-alert--info dex-note">
+        <div className="aa-alert__body">
+          List แสดงเฉพาะ number · name · artwork — types/stats โหลดตอนเปิด detail. artwork ถูก derive
+          จาก id (ยิง PokeAPI ครั้งเดียวต่อหน้า) เพื่อเลี่ยง N+1 waterfall.
+        </div>
+      </div>
+
+      <div className="dex-grid">
+        {items.map((p) => (
+          <a key={p.id} className="aa-card aa-card--interactive dex-card" href={p.detailHref}>
+            <div className="dex-card__art">
+              <span className="dex-card__num">{p.num}</span>
+              <img className="dex-card__img" src={p.artwork} alt={p.displayName} loading="lazy" />
+            </div>
+            <div className="dex-card__body">{p.displayName}</div>
+          </a>
+        ))}
+      </div>
+
+      <div className="dex-pager">
+        <div className="dex-pager__info">{showingLabel}</div>
+        <div className="dex-pager__nav">
+          {hasPrev ? (
+            <a className="aa-btn aa-btn--secondary aa-btn--sm" href={prevHref}>
+              ‹ Prev
+            </a>
+          ) : (
+            <span className="aa-btn aa-btn--secondary aa-btn--sm dex-pager__btn--off">‹ Prev</span>
+          )}
+          <span className="dex-pager__page">{pageLabel}</span>
+          {hasNext ? (
+            <a className="aa-btn aa-btn--secondary aa-btn--sm" href={nextHref}>
+              Next ›
+            </a>
+          ) : (
+            <span className="aa-btn aa-btn--secondary aa-btn--sm dex-pager__btn--off">Next ›</span>
+          )}
+        </div>
+      </div>
+    </PageLayout>
+  )
+}

package/example/pokedex/pages/TypeChart.tsx

@@ -0,0 +1,51 @@
+// Route "/type-chart" — NATIVE route. A static 18×18 type-effectiveness matrix:
+// pure read-only data, the ideal native page (compiled to jinja, rendered in
+// Rust, zero React on the server). The 19×19 grid is pre-flattened in the loader
+// to a single row-major `cells` array so the template uses ONE `.map()` into a
+// CSS grid (nested maps aren't proven on the native path — see GAPS S10).
+import PageLayout from '../components/PageLayout'
+import type { TypeChartData } from '../lib/types'
+
+export default function TypeChart({ cells, teamProps }: TypeChartData) {
+  return (
+    <PageLayout
+      native
+      title="PokéDex · type chart"
+      active="typechart"
+      crumb="Type chart"
+      teamProps={teamProps}
+    >
+      <div className="aa-page-header">
+        <div>
+          <h1 className="aa-page-header__title">Type chart</h1>
+          <div className="aa-page-header__desc">
+            Damage relations · row attacks column · rendered ฝั่ง Rust จาก jinja (native:true · ไม่มี
+            React runtime ใน payload)
+          </div>
+        </div>
+      </div>
+
+      <div className="dex-tc-legend">
+        <span className="dex-tc-legend__item">
+          <span className="dex-tc__cell dex-tc__cell--super dex-tc__swatch">2</span> super effective
+        </span>
+        <span className="dex-tc-legend__item">
+          <span className="dex-tc__cell dex-tc__cell--weak dex-tc__swatch">½</span> not very
+        </span>
+        <span className="dex-tc-legend__item">
+          <span className="dex-tc__cell dex-tc__cell--none dex-tc__swatch">0</span> no effect
+        </span>
+      </div>
+
+      <div className="dex-tc-scroll">
+        <div className="dex-tc">
+          {cells.map((c) => (
+            <div key={c.id} className={c.className} title={c.title}>
+              {c.content}
+            </div>
+          ))}
+        </div>
+      </div>
+    </PageLayout>
+  )
+}

package/example/pokedex/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><circle cx="16" cy="16" r="15" fill="#ef4444"/><rect x="1" y="14" width="30" height="4" fill="#111"/><circle cx="16" cy="16" r="5" fill="#fff" stroke="#111" stroke-width="2"/></svg>

package/example/pokedex/routes.tsx

@@ -0,0 +1,21 @@
+import { defineRoutes } from 'brustjs/routes'
+import { detailLoader, listLoader, typeChartLoader } from './lib/loaders'
+import DetailPage from './pages/DetailPage'
+import ListPage from './pages/ListPage'
+import TypeChart from './pages/TypeChart'
+
+// Every route is `native: true` — each page is compiled from JSX to a minijinja
+// template at build time and rendered in Rust (no per-request React). The loader
+// runs in a Bun worker and its return value becomes the template scope. The only
+// React that ever boots in the browser is the islands (TeamBuilder /
+// AddToTeamButton). See ./FRAMEWORK-GAPS.md for what this costs.
+export const routes = defineRoutes([
+  // List + pagination (query string via req.search, validated by hand in the loader).
+  { path: '/', Component: ListPage, native: true, loader: listLoader },
+
+  // Dynamic param {name} + a (non-streamed) evolution chain loaded in the loader.
+  { path: '/pokemon/{name}', Component: DetailPage, native: true, loader: detailLoader },
+
+  // Static 18×18 effectiveness matrix — the ideal native page.
+  { path: '/type-chart', Component: TypeChart, native: true, loader: typeChartLoader },
+])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brustjs",
-  "version": "0.1.16-alpha",
+  "version": "0.1.18-alpha",
   "description": "Bun + Rust SSR framework — React on the server, Rust everywhere else (napi cdylib + per-worker SharedArrayBuffer).",
   "license": "MIT",
   "repository": {
@@ -40,12 +40,12 @@
     "typescript": "^6.0.3"
   },
   "optionalDependencies": {
-    "brustjs-darwin-x64": "0.1.16-alpha",
-    "brustjs-darwin-arm64": "0.1.16-alpha",
-    "brustjs-linux-x64-gnu": "0.1.16-alpha",
-    "brustjs-linux-arm64-gnu": "0.1.16-alpha",
-    "brustjs-linux-x64-musl": "0.1.16-alpha",
-    "brustjs-linux-arm64-musl": "0.1.16-alpha"
+    "brustjs-darwin-x64": "0.1.18-alpha",
+    "brustjs-darwin-arm64": "0.1.18-alpha",
+    "brustjs-linux-x64-gnu": "0.1.18-alpha",
+    "brustjs-linux-arm64-gnu": "0.1.18-alpha",
+    "brustjs-linux-x64-musl": "0.1.18-alpha",
+    "brustjs-linux-arm64-musl": "0.1.18-alpha"
   },
   "peerDependencies": {
     "react": "^19.2.6",
@@ -74,7 +74,13 @@
     "!runtime/node_modules",
     "!runtime/package.json",
     "!runtime/*.node",
-    "!runtime/**/*.test.ts"
+    "!runtime/**/*.test.ts",
+    "example/pokedex",
+    "!example/pokedex/FRAMEWORK-GAPS.md",
+    "!example/pokedex/README.md",
+    "!example/pokedex/.brust",
+    "!example/pokedex/dist",
+    "!example/pokedex/node_modules"
   ],
   "publishConfig": {
     "access": "public"

package/runtime/cli/build.ts

@@ -351,6 +351,18 @@ export async function runBuild(args: string[]): Promise<void> {
     }
   }
 
+  // Static public assets: copy <project>/public → <dist>/public so a deployed
+  // dist is self-contained. No .brust mirror — the source/dev runtime reads
+  // <scanRoot>/public directly.
+  const publicSrc = path.join(entryDir, 'public')
+  if (existsSync(publicSrc)) {
+    const publicOut = path.join(outDir, 'public')
+    await cp(publicSrc, publicOut, { recursive: true })
+    console.log(`[brust build] public:  ${publicSrc} → ${publicOut}`)
+  } else {
+    console.log('[brust build] public:  skipped (no public/ dir)')
+  }
+
   // 5. Bun.build the server bundle with the native shim plugin + banner. No
   // actions codegen: `defineActions(...)` actions register via the app entry's
   // `import { actions } from './actions'` → `brust.run({ actions })` path, which

package/runtime/cli/help.ts

@@ -65,10 +65,15 @@ export const COMMANDS: CommandDef[] = [
   {
     name: 'new',
     summary: 'Scaffold a new brust project',
-    usage: 'brust new <name> [options]',
+    usage: 'brust new <name> [--dir <path>] [--template <name>] [--yes]',
     flags: [
       { flag: '<name>', desc: 'Project name (lowercase letters, digits, - _)' },
       { flag: '--dir <path>', desc: 'Target directory (default ./<name>)' },
+      {
+        flag: '--template, -t <name>',
+        desc: 'Template to scaffold (minimal | pokedex). Prompts if omitted on a TTY; defaults to minimal otherwise.',
+      },
+      { flag: '--yes, -y', desc: 'Skip the prompt; use the default template (minimal).' },
     ],
   },
 ]

package/runtime/cli/new.ts

@@ -1,8 +1,13 @@
 import { existsSync, readFileSync } from 'node:fs'
 import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises'
 import { dirname, isAbsolute, join, resolve } from 'node:path'
-
-const TEMPLATE_DIR = join(import.meta.dir, 'templates', 'minimal')
+import {
+  DEFAULT_TEMPLATE,
+  type EmittedFile,
+  findBrustPackageRoot,
+  listTemplates,
+  type TemplateDef,
+} from './templates.ts'
 
 const NAME_RE = /^[a-z0-9][a-z0-9_-]*$/
 const MAX_NAME_LEN = 50
@@ -10,11 +15,15 @@ const MAX_NAME_LEN = 50
 export interface ParsedNewArgs {
   projectName: string
   targetDir: string
+  template?: string
+  yes: boolean
 }
 
 export function parseArgs(args: string[]): ParsedNewArgs {
   let name: string | undefined
   let dir: string | undefined
+  let template: string | undefined
+  let yes = false
 
   for (let i = 0; i < args.length; i++) {
     const a = args[i]!
@@ -23,6 +32,15 @@ export function parseArgs(args: string[]): ParsedNewArgs {
       if (!dir) throw new Error('brust new: --dir requires a value')
     } else if (a.startsWith('--dir=')) {
       dir = a.slice('--dir='.length)
+      if (!dir) throw new Error('brust new: --dir requires a value')
+    } else if (a === '--template' || a === '-t') {
+      template = args[++i]
+      if (!template) throw new Error('brust new: --template requires a value')
+    } else if (a.startsWith('--template=')) {
+      template = a.slice('--template='.length)
+      if (!template) throw new Error('brust new: --template requires a value')
+    } else if (a === '--yes' || a === '-y') {
+      yes = true
     } else if (a.startsWith('-')) {
       throw new Error(`brust new: unknown flag "${a}"`)
     } else if (name === undefined) {
@@ -47,7 +65,7 @@ export function parseArgs(args: string[]): ParsedNewArgs {
   const cwd = process.cwd()
   const targetDir = dir ? (isAbsolute(dir) ? dir : resolve(cwd, dir)) : resolve(cwd, name)
 
-  return { projectName: name, targetDir }
+  return { projectName: name, targetDir, template, yes }
 }
 
 export interface BrustRef {
@@ -70,35 +88,21 @@ function hasSourceMarkers(dir: string): boolean {
 }
 
 export function resolveBrustRef(startDir: string = import.meta.dir): BrustRef {
-  let dir = startDir
-  while (true) {
-    const pkgPath = join(dir, 'package.json')
-    if (existsSync(pkgPath)) {
-      try {
-        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
-        if (pkg.name === 'brustjs') {
-          if (hasSourceMarkers(dir)) {
-            return { kind: 'file', spec: `file:${dir}` }
-          }
-          const version = typeof pkg.version === 'string' ? pkg.version : '0.0.0'
-          return { kind: 'version', spec: `^${version}` }
-        }
-      } catch {
-        // malformed package.json — keep walking
-      }
-    }
-    const parent = dirname(dir)
-    if (parent === dir) {
-      throw new Error('brust new: cannot locate the brust package — is your installation intact?')
-    }
-    dir = parent
+  const dir = findBrustPackageRoot(startDir)
+  if (hasSourceMarkers(dir)) {
+    return { kind: 'file', spec: `file:${dir}` }
   }
+  const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'))
+  const version = typeof pkg.version === 'string' ? pkg.version : '0.0.0'
+  return { kind: 'version', spec: `^${version}` }
 }
 
 export interface CopyTemplateOpts {
   templateDir: string
   targetDir: string
   substitutions: Record<string, string>
+  exclude?: Set<string>
+  extraFiles?: EmittedFile[]
 }
 
 export async function copyTemplate(opts: CopyTemplateOpts): Promise<void> {
@@ -107,27 +111,38 @@ export async function copyTemplate(opts: CopyTemplateOpts): Promise<void> {
       `brust new: template directory not found at ${opts.templateDir}; this is a brust installation bug`,
     )
   }
-  await copyDir(opts.templateDir, opts.targetDir, opts.substitutions)
+  await copyDir(opts.templateDir, opts.targetDir, opts.substitutions, opts.exclude ?? new Set(), '')
+  for (const f of opts.extraFiles ?? []) {
+    const dstPath = join(opts.targetDir, f.relPath)
+    await mkdir(dirname(dstPath), { recursive: true })
+    await writeFile(dstPath, f.content)
+  }
 }
 
-async function copyDir(src: string, dst: string, subs: Record<string, string>): Promise<void> {
+async function copyDir(
+  src: string,
+  dst: string,
+  subs: Record<string, string>,
+  exclude: Set<string>,
+  relBase: string,
+): Promise<void> {
   await mkdir(dst, { recursive: true })
   const entries = await readdir(src, { withFileTypes: true })
   for (const ent of entries) {
+    const relPath = relBase ? `${relBase}/${ent.name}` : ent.name
+    if (exclude.has(relPath)) continue
     const srcPath = join(src, ent.name)
     const dstName = renameForEmit(ent.name)
     const dstPath = join(dst, dstName)
     if (ent.isDirectory()) {
-      await copyDir(srcPath, dstPath, subs)
+      await copyDir(srcPath, dstPath, subs, exclude, relPath)
     } else if (ent.isFile()) {
       const isTmpl = ent.name.endsWith('.tmpl')
       if (isTmpl) {
         const raw = await readFile(srcPath, 'utf8')
-        const out = applySubstitutions(raw, subs)
-        await writeFile(dstPath, out)
+        await writeFile(dstPath, applySubstitutions(raw, subs))
       } else {
-        const buf = await readFile(srcPath)
-        await writeFile(dstPath, buf)
+        await writeFile(dstPath, await readFile(srcPath))
       }
     }
   }
@@ -147,6 +162,63 @@ function applySubstitutions(text: string, subs: Record<string, string>): string
   return out
 }
 
+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(
+        `brust new: 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++) {
+      const t = templates[i]!
+      print(`  ${i + 1}) ${t.name} — ${t.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
+}
+
 export async function runNew(args: string[]): Promise<void> {
   let parsed: ParsedNewArgs
   try {
@@ -175,14 +247,28 @@ export async function runNew(args: string[]): Promise<void> {
     process.exit(1)
   }
 
+  let tmpl: TemplateDef
+  try {
+    tmpl = selectTemplate({
+      explicit: parsed.template,
+      yes: parsed.yes,
+      isTTY: Boolean(process.stdin.isTTY),
+    })
+  } catch (e) {
+    console.error(e instanceof Error ? e.message : String(e))
+    process.exit(1)
+  }
+
   try {
     await copyTemplate({
-      templateDir: TEMPLATE_DIR,
+      templateDir: tmpl.sourceDir,
       targetDir,
       substitutions: {
         __PROJECT_NAME__: projectName,
         __BRUST_DEP__: JSON.stringify(brustRef.spec),
       },
+      exclude: tmpl.exclude,
+      extraFiles: tmpl.extraFiles?.({ projectName, brustSpec: brustRef.spec }),
     })
   } catch (e) {
     if (!targetExisted) {
@@ -192,17 +278,17 @@ export async function runNew(args: string[]): Promise<void> {
     process.exit(1)
   }
 
-  printNextSteps(projectName, targetDir)
+  printNextSteps(projectName, targetDir, tmpl.name)
 }
 
-function printNextSteps(name: string, targetDir: string): void {
+function printNextSteps(name: string, targetDir: string, template: string): void {
   const cwd = process.cwd()
-  const displayPath = targetDir.startsWith(cwd + '/')
-    ? './' + targetDir.slice(cwd.length + 1)
+  const displayPath = targetDir.startsWith(`${cwd}/`)
+    ? `./${targetDir.slice(cwd.length + 1)}`
     : targetDir
-  console.log(`Created ${name} at ${targetDir}\n`)
-  console.log(`Next:`)
+  console.log(`Created ${name} at ${targetDir} (template: ${template})\n`)
+  console.log('Next:')
   console.log(`  cd ${displayPath}`)
-  console.log(`  bun install`)
-  console.log(`  bun run dev`)
+  console.log('  bun install')
+  console.log('  bun run dev')
 }