@alfredmouelle/create-stack 0.1.0

package/lib/env.mjs

@@ -0,0 +1,56 @@
+// Rebuilds src/env.ts `server` + `runtimeEnv` blocks from the final key set,
+// and generates .env.example + .env. Adds keys (e.g. a swapped mailer provider)
+// and prunes keys of stripped foundations/capabilities — deterministically.
+
+import { editFile, join, write } from './util.mjs'
+
+/** valibot schema text per known env key. */
+const SCHEMAS = {
+  DATABASE_URL: 'v.pipe(v.string(), v.url())',
+  BETTER_AUTH_URL: 'v.pipe(v.string(), v.url())',
+  BETTER_AUTH_SECRET: 'v.pipe(v.string(), v.minLength(1))',
+  BETTER_AUTH_GOOGLE_CLIENT_ID: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
+  BETTER_AUTH_GOOGLE_CLIENT_SECRET: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
+  EMAIL_FROM: "v.optional(v.pipe(v.string(), v.email()), 'no-reply@example.com')",
+  RESEND_API_KEY: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
+  BREVO_API_KEY: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
+  AWS_REGION: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
+  AWS_ACCESS_KEY_ID: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
+  AWS_SECRET_ACCESS_KEY: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
+}
+
+/** Placeholder values for the generated .env files. */
+const PLACEHOLDERS = {
+  DATABASE_URL: 'postgres://postgres:postgres@localhost:5432/app',
+  BETTER_AUTH_URL: 'http://localhost:3000',
+  BETTER_AUTH_SECRET: 'change-me-with-a-long-random-string',
+  EMAIL_FROM: 'no-reply@example.com',
+}
+
+const indent = (s) => `    ${s}`
+
+/** Write the final env.ts and .env files. `keys` is an ordered string[]. */
+export function writeEnv(projectDir, keys) {
+  const seen = new Set()
+  const ordered = keys.filter((k) => SCHEMAS[k] && !seen.has(k) && seen.add(k))
+
+  const serverBody = ordered.map((k) => indent(`${k}: ${SCHEMAS[k]},`)).join('\n')
+  const runtimeBody = [
+    indent('NODE_ENV: process.env.NODE_ENV,'),
+    ...ordered.map((k) => indent(`${k}: process.env.${k},`)),
+  ].join('\n')
+
+  editFile(join(projectDir, 'src/env.ts'), (src) => {
+    let out = src.replace(/ {2}server: \{[\s\S]*?\n {2}\},/, `  server: {\n${serverBody}\n  },`)
+    out = out.replace(
+      / {2}runtimeEnv: \{[\s\S]*?\n {2}\},/,
+      `  runtimeEnv: {\n${runtimeBody}\n  },`,
+    )
+    return out
+  })
+
+  const lines = ordered.map((k) => `${k}=${PLACEHOLDERS[k] ?? ''}`)
+  const body = `${lines.join('\n')}\n`
+  write(join(projectDir, '.env.example'), body)
+  write(join(projectDir, '.env'), body)
+}

package/lib/identity.mjs

@@ -0,0 +1,33 @@
+// Step A4 — stamp the project identity: title/meta + a README that ends with
+// the stack's `# Author` footer verbatim.
+
+import { STACK_ROOT } from './manifests.mjs'
+import { editFile, join, read, write } from './util.mjs'
+
+const titleFiles = {
+  next: ['src/app/layout.tsx'],
+  tanstack: ['src/routes/__root.tsx'],
+}
+
+export function stampIdentity(projectDir, projectName, framework) {
+  // Swap the placeholder title 'App' in the root document/metadata.
+  for (const rel of titleFiles[framework === 'next' ? 'next' : 'tanstack']) {
+    editFile(join(projectDir, rel), (c) => c.replaceAll("title: 'App'", `title: '${projectName}'`))
+  }
+
+  const footer = read(join(STACK_ROOT, 'patterns/_baseline/README-author.md'))
+  const readme = `# ${projectName}
+
+Bootstrapped from the personal reference stack.
+
+## Getting started
+
+\`\`\`bash
+pnpm install
+cp .env.example .env   # fill in the values
+pnpm dev
+\`\`\`
+
+${footer}`
+  write(join(projectDir, 'README.md'), readme)
+}

package/lib/mailer.mjs

@@ -0,0 +1,95 @@
+// Mailer provider swap. The base inlines the Resend adapter; if the user picks
+// another provider we swap the adapter files + the composition root (email/index.ts)
+// and return the dep/env deltas. Mirrors the mailer capability manifest.
+
+import { STACK_ROOT } from './manifests.mjs'
+import { copy, join, readJSON, remove, write } from './util.mjs'
+
+const EMAIL_DIR = 'src/server/email'
+
+/** getMailer() body per provider (composition root in email/index.ts). */
+const FACTORY = {
+  brevo: {
+    import: "import { brevoAdapter } from './adapters/brevo/index'",
+    adapter: "brevoAdapter({ apiKey: required(env.BREVO_API_KEY, 'BREVO_API_KEY') })",
+    envKeys: ['EMAIL_FROM', 'BREVO_API_KEY'],
+    pkgDep: '@getbrevo/brevo',
+  },
+  ses: {
+    import: "import { sesAdapter } from './adapters/ses/index'",
+    // SESv2 SDK reads AWS_REGION / AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY from env.
+    adapter: 'sesAdapter()',
+    envKeys: ['EMAIL_FROM', 'AWS_REGION', 'AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY'],
+    pkgDep: '@aws-sdk/client-sesv2',
+  },
+}
+
+const REQUIRED_HELPER = `
+function required(value: string | undefined, name: string): string {
+  if (!value) throw new Error(\`\${name} is required to send email\`)
+  return value
+}
+`
+
+const INDEX_TS = (cfg) => `import type { ReactElement } from 'react'
+import { env } from '~/env'
+${cfg.import}
+import type { MailAddress, Mailer } from './core/port'
+import { createMailer } from './factory'
+
+export type EmailRecipient = MailAddress
+${cfg.adapter.includes('required(') ? REQUIRED_HELPER : ''}
+let mailer: Mailer | null = null
+function getMailer(): Mailer {
+  if (!mailer) {
+    mailer = createMailer({
+      from: env.EMAIL_FROM,
+      adapter: ${cfg.adapter},
+    })
+  }
+  return mailer
+}
+
+export async function sendEmail(params: {
+  to: EmailRecipient
+  subject: string
+  template: ReactElement
+}) {
+  return getMailer().send({
+    to: params.to,
+    subject: params.subject,
+    react: params.template,
+  })
+}
+`
+
+/**
+ * Swap the inlined mailer to `provider`. Returns { addDeps, removeDeps, envKeys }.
+ * provider === 'resend' is a no-op (the base default).
+ */
+export function swapMailer(projectDir, provider) {
+  if (provider === 'resend') {
+    return { addDeps: {}, removeDeps: [], envKeys: ['EMAIL_FROM', 'RESEND_API_KEY'] }
+  }
+  const cfg = FACTORY[provider]
+  if (!cfg) throw new Error(`Unknown mailer provider: ${provider}`)
+
+  // Swap adapter files: drop resend, copy the chosen adapter from the package.
+  remove(join(projectDir, EMAIL_DIR, 'adapters/resend'))
+  copy(
+    join(STACK_ROOT, 'packages/mailer/src/adapters', provider),
+    join(projectDir, EMAIL_DIR, 'adapters', provider),
+  )
+
+  // Rewrite the composition root.
+  write(join(projectDir, EMAIL_DIR, 'index.ts'), INDEX_TS(cfg))
+
+  // Dep delta — pull the provider's range from the mailer package manifest.
+  const mailerPkg = readJSON(join(STACK_ROOT, 'packages/mailer/package.json'))
+  const range = mailerPkg.dependencies?.[cfg.pkgDep] ?? 'latest'
+  return {
+    addDeps: { [cfg.pkgDep]: range },
+    removeDeps: ['resend'],
+    envKeys: cfg.envKeys,
+  }
+}

package/lib/manifests.mjs

@@ -0,0 +1,61 @@
+// Loads the stack's pattern + capability manifests so the CLI stays
+// data-driven (file lists, deps, env come from the manifests, not hardcoded).
+// Only the few code "seams" (trpc/auth wiring) are hardcoded in strip.mjs.
+
+import { existsSync, readdirSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { readJSON } from './util.mjs'
+
+const here = dirname(fileURLToPath(import.meta.url))
+// Published: assets are bundled into cli/_stack (see scripts/bundle.mjs).
+// Dev (inside the monorepo): read them straight from the repo root.
+const bundled = resolve(here, '..', '_stack')
+export const STACK_ROOT = existsSync(bundled) ? bundled : resolve(here, '..', '..')
+
+export const loadPatterns = () => {
+  const dir = join(STACK_ROOT, 'patterns')
+  const out = {}
+  for (const name of readdirSync(dir)) {
+    if (name.startsWith('_') || name === 'README.md') continue
+    try {
+      out[name] = readJSON(join(dir, name, 'pattern.json'))
+    } catch {
+      // not a pattern dir
+    }
+  }
+  return out
+}
+
+export const loadCapabilities = () => {
+  const dir = join(STACK_ROOT, 'packages')
+  const out = {}
+  for (const name of readdirSync(dir)) {
+    try {
+      out[name] = readJSON(join(dir, name, 'capability.json'))
+    } catch {
+      // not a capability package
+    }
+  }
+  return out
+}
+
+/**
+ * Logical foundations the wizard offers, mapped to the concrete manifest name
+ * per framework. The base apps always contain ALL of these — selection = keep.
+ */
+export const foundationManifest = (logical, framework) => {
+  const next = framework === 'next'
+  switch (logical) {
+    case 'drizzle':
+      return 'drizzle'
+    case 'data-table':
+      return 'data-table'
+    case 'trpc':
+      return next ? 'trpc-next' : 'trpc'
+    case 'better-auth':
+      return next ? 'better-auth-next' : 'better-auth'
+    default:
+      return logical
+  }
+}

package/lib/scaffold.mjs

@@ -0,0 +1,49 @@
+// Step A2 — fork a base app into the target dir and make it standalone
+// (its own Biome config, pnpm workspace + build allowlist, project name).
+
+import { STACK_ROOT } from './manifests.mjs'
+import { copy, exists, join, readJSON, run, write, writeJSON } from './util.mjs'
+
+const RSYNC_EXCLUDES = [
+  'node_modules',
+  '.next',
+  '.output',
+  '.nitro',
+  '.tanstack',
+  'dist',
+  'src/routeTree.gen.ts',
+  '.env',
+  '.env.local',
+]
+
+const PNPM_WORKSPACE = `allowBuilds:
+  esbuild: true
+  sharp: true
+  lightningcss: true
+`
+
+/** Copy the base app into projectDir, minus build output & generated files. */
+export function forkBase(framework, projectDir) {
+  const base = join(STACK_ROOT, 'apps', framework === 'next' ? 'next-base' : 'tanstack-base')
+  if (!exists(base)) throw new Error(`Base app not found: ${base}`)
+  const args = ['-a']
+  for (const ex of RSYNC_EXCLUDES) args.push('--exclude', ex)
+  args.push(`${base}/.`, `${projectDir}/`)
+  if (!run('rsync', args)) throw new Error('rsync failed while forking the base app')
+}
+
+/** Make the fork standalone (Biome, pnpm workspace, package.json identity). */
+export function makeStandalone(projectDir, projectName) {
+  // A fork needs its own Biome config (the base inherits the monorepo root's).
+  copy(join(STACK_ROOT, 'patterns/_baseline/biome.jsonc'), join(projectDir, 'biome.jsonc'))
+
+  // Avoid ERR_PNPM_IGNORED_BUILDS on a fresh install (native build scripts).
+  write(join(projectDir, 'pnpm-workspace.yaml'), PNPM_WORKSPACE)
+
+  const pkgPath = join(projectDir, 'package.json')
+  const pkg = readJSON(pkgPath)
+  pkg.name = projectName
+  delete pkg.private // a leaf project; let the user decide
+  pkg.private = true
+  writeJSON(pkgPath, pkg)
+}

package/lib/strip.mjs

@@ -0,0 +1,132 @@
+// Step A3 — reverse-strip the foundations the user did NOT select.
+// Whole-directory deletes (robust against orphans) + the few code "seams"
+// that need surgery (trpc/auth wiring) via shipped reduced variants.
+
+import { dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { foundationManifest } from './manifests.mjs'
+import { copy, editFile, join, remove } from './util.mjs'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const tpl = (rel) => join(here, '..', 'templates', rel)
+
+const ALWAYS_KEEP = new Set(['valibot'])
+
+const manifestDeps = (m) => [...(m?.deps ?? []), ...(m?.devDeps ?? [])]
+
+/** Logical foundations always present in a base app. */
+export const FOUNDATIONS = ['drizzle', 'trpc', 'better-auth', 'data-table']
+
+/**
+ * Strip the unselected foundations from the fork.
+ * @returns {{ removeDeps: string[], removeScripts: string[] }}
+ */
+export function stripFoundations({ projectDir, framework, kept, keptMailer, patterns }) {
+  const next = framework === 'next'
+  const src = (p) => join(projectDir, 'src', p)
+  const dropped = FOUNDATIONS.filter((f) => !kept.has(f))
+
+  // Dep diff: remove a dropped foundation's deps unless a kept one still needs it.
+  const keptDeps = new Set(
+    [...kept].flatMap((f) => manifestDeps(patterns[foundationManifest(f, framework)])),
+  )
+  const removeDeps = new Set()
+  const removeScripts = new Set()
+  for (const f of dropped) {
+    const m = patterns[foundationManifest(f, framework)]
+    for (const d of manifestDeps(m)) {
+      if (!keptDeps.has(d) && !ALWAYS_KEEP.has(d)) removeDeps.add(d)
+    }
+    for (const s of Object.keys(m?.scripts ?? {})) removeScripts.add(s)
+  }
+
+  // --- data-table ---
+  if (dropped.includes('data-table')) {
+    for (const f of ['data-table.tsx', 'infinite-data-table.tsx', 'sortable-header.tsx']) {
+      remove(src(join('components', f)))
+    }
+  }
+
+  // --- trpc (delete dirs + swap root wiring) ---
+  if (dropped.includes('trpc')) {
+    remove(src('trpc'))
+    remove(src('server/api'))
+    if (next) {
+      remove(src('app/api/trpc'))
+      copy(tpl('next/layout.no-trpc.tsx'), src('app/layout.tsx'))
+    } else {
+      remove(src('routes/api.trpc.$.tsx'))
+      copy(tpl('tanstack/router.no-trpc.tsx'), src('router.tsx'))
+      copy(tpl('tanstack/__root.no-trpc.tsx'), src('routes/__root.tsx'))
+      // extra TanStack wiring deps that only make sense with trpc/react-query
+      for (const d of [
+        '@tanstack/react-query',
+        '@tanstack/react-query-devtools',
+        '@tanstack/react-router-ssr-query',
+        'superjson',
+      ]) {
+        if (!keptDeps.has(d)) removeDeps.add(d)
+      }
+    }
+  }
+
+  // --- better-auth ---
+  if (dropped.includes('better-auth')) {
+    remove(src('server/better-auth'))
+    remove(src('server/db/schemas/auth.schema.ts'))
+    if (next) {
+      remove(src('app/auth'))
+      remove(src('app/api/auth'))
+      remove(src('app/dashboard'))
+      remove(src('server/auth'))
+      remove(src('features/auth'))
+    } else {
+      remove(src('routes/auth.tsx'))
+      remove(src('routes/auth'))
+      remove(src('routes/_authed.tsx'))
+      remove(src('routes/_authed'))
+      remove(src('routes/api/auth'))
+      remove(src('features/auth'))
+    }
+    // drop the auth.schema barrel line (kept drizzle owns the barrel)
+    editFile(src('server/db/schemas/index.ts'), (c) => {
+      const out = c
+        .split('\n')
+        .filter((l) => !l.includes("'./auth.schema'"))
+        .join('\n')
+      // keep it a module even when empty, so `import * as schema` still resolves
+      return /^export /m.test(out) ? out : `${out.trimEnd()}\nexport {}\n`
+    })
+    // if trpc survives, strip auth out of its context
+    if (kept.has('trpc')) editFile(src('server/api/trpc.ts'), stripAuthFromTrpc)
+  }
+
+  // --- mailer / email-kit (inlined in the base; needed only by better-auth) ---
+  if (!keptMailer) {
+    remove(src('server/email'))
+    remove(src('emails'))
+    for (const d of ['resend', 'react-email']) removeDeps.add(d)
+    removeScripts.add('email:dev')
+  }
+
+  // --- drizzle (only droppable when nothing depends on it) ---
+  if (dropped.includes('drizzle')) {
+    remove(src('server/db'))
+    remove(join(projectDir, 'drizzle.config.ts'))
+  }
+
+  return { removeDeps: [...removeDeps], removeScripts: [...removeScripts] }
+}
+
+/** Remove better-auth coupling from a tRPC context file (both frameworks). */
+function stripAuthFromTrpc(src) {
+  return src
+    .replace(
+      "import { initTRPC, TRPCError } from '@trpc/server'",
+      "import { initTRPC } from '@trpc/server'",
+    )
+    .replace("import { auth } from '~/server/better-auth'\n", '')
+    .replace('  const session = await auth.api.getSession({ headers: opts.headers })\n', '')
+    .replace('return { db, session, ...opts }', 'return { db, ...opts }')
+    .replace(/\n+export const protectedProcedure = t\.procedure[\s\S]*$/, '\n')
+}

package/lib/util.mjs

@@ -0,0 +1,82 @@
+// Small fs / exec / package.json helpers shared by the CLI modules.
+// No external deps — keep the CLI lean and instantly runnable.
+
+import { spawnSync } from 'node:child_process'
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync,
+} from 'node:fs'
+import { dirname, join } from 'node:path'
+
+export const read = (p) => readFileSync(p, 'utf8')
+export const write = (p, c) => {
+  mkdirSync(dirname(p), { recursive: true })
+  writeFileSync(p, c)
+}
+export const exists = (p) => existsSync(p)
+export const readJSON = (p) => JSON.parse(read(p))
+export const writeJSON = (p, obj) => write(p, `${JSON.stringify(obj, null, 2)}\n`)
+
+/** Remove a file or directory if it exists (recursive, never throws on absent). */
+export const remove = (p) => {
+  if (existsSync(p)) rmSync(p, { recursive: true, force: true })
+}
+
+/** Copy a file or directory tree. */
+export const copy = (from, to) => {
+  mkdirSync(dirname(to), { recursive: true })
+  cpSync(from, to, { recursive: true })
+}
+
+/** Edit a file in place via a (content) => content transform. No-op if absent. */
+export const editFile = (p, fn) => {
+  if (!existsSync(p)) return false
+  const next = fn(read(p))
+  if (next != null) write(p, next)
+  return true
+}
+
+/** Is a directory empty (or absent)? Ignores common noise files. */
+export const isDirEmpty = (p) => {
+  if (!existsSync(p)) return true
+  const noise = new Set(['.git', '.DS_Store'])
+  return readdirSync(p).every((f) => noise.has(f))
+}
+
+/** Run a command, inheriting stdio. Returns true on exit 0. */
+export const run = (cmd, args, opts = {}) => {
+  const res = spawnSync(cmd, args, { stdio: 'inherit', ...opts })
+  return res.status === 0
+}
+
+/** Run a command capturing stdout (trimmed). Returns '' on failure. */
+export const runCapture = (cmd, args, opts = {}) => {
+  const res = spawnSync(cmd, args, { encoding: 'utf8', ...opts })
+  return res.status === 0 ? (res.stdout || '').trim() : ''
+}
+
+export { join }
+
+// --- package.json helpers (operate on a parsed object, mutate in place) ---
+
+export const pkgRemoveDeps = (pkg, names) => {
+  for (const field of ['dependencies', 'devDependencies']) {
+    if (!pkg[field]) continue
+    for (const name of names) delete pkg[field][name]
+  }
+}
+
+export const pkgRemoveScripts = (pkg, names) => {
+  if (!pkg.scripts) return
+  for (const name of names) delete pkg.scripts[name]
+}
+
+export const pkgAddDeps = (pkg, deps, field = 'dependencies') => {
+  pkg[field] = pkg[field] || {}
+  for (const [name, range] of Object.entries(deps)) pkg[field][name] = range
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@alfredmouelle/create-stack",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Interactive, deterministic installer for the personal reference stack — forks a base app (Next.js / TanStack Start) and strips it to your selection.",
+  "author": {
+    "name": "Alfred MOUELLE",
+    "email": "alfredmouelle@gmail.com",
+    "url": "https://alfredmouelle.com"
+  },
+  "license": "MIT",
+  "keywords": [
+    "create",
+    "scaffold",
+    "starter",
+    "boilerplate",
+    "tanstack-start",
+    "nextjs",
+    "drizzle",
+    "trpc",
+    "better-auth"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alfredmouelle/stack.git",
+    "directory": "cli"
+  },
+  "bin": {
+    "create-stack": "./index.mjs"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "index.mjs",
+    "lib",
+    "templates",
+    "_stack",
+    "README.md"
+  ],
+  "scripts": {
+    "bundle": "node scripts/bundle.mjs",
+    "prepack": "node scripts/bundle.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.6.0"
+  }
+}

package/templates/next/layout.no-trpc.tsx

@@ -0,0 +1,22 @@
+import type { Metadata } from 'next'
+import type { ReactNode } from 'react'
+import { ThemeProvider } from '~/components/theme-provider'
+import './globals.css'
+
+export const metadata: Metadata = {
+  title: 'App',
+  description: 'Next.js base.',
+  authors: [{ name: 'Alfred MOUELLE', url: 'https://alfredmouelle.com' }],
+}
+
+export default function RootLayout({ children }: Readonly<{ children: ReactNode }>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body>
+        <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
+          {children}
+        </ThemeProvider>
+      </body>
+    </html>
+  )
+}

package/templates/tanstack/__root.no-trpc.tsx

@@ -0,0 +1,63 @@
+import { TanStackDevtools } from '@tanstack/react-devtools'
+import { createRootRoute, HeadContent, Scripts } from '@tanstack/react-router'
+import { TanStackRouterDevtoolsPanel } from '@tanstack/react-router-devtools'
+
+import appCss from '../styles.css?url'
+
+// Runs before hydration to set the theme class and avoid a flash of wrong theme.
+const themeScript = `(function(){try{var t=localStorage.getItem('theme')||'system';var m=window.matchMedia('(prefers-color-scheme:dark)').matches;document.documentElement.classList.toggle('dark',t==='dark'||(t==='system'&&m));}catch(e){}})();`
+
+export const Route = createRootRoute({
+  head: () => ({
+    meta: [
+      {
+        charSet: 'utf-8',
+      },
+      {
+        name: 'viewport',
+        content: 'width=device-width, initial-scale=1',
+      },
+      {
+        name: 'author',
+        content: 'Alfred MOUELLE',
+      },
+      {
+        title: 'App',
+      },
+    ],
+    links: [
+      {
+        rel: 'stylesheet',
+        href: appCss,
+      },
+    ],
+  }),
+  shellComponent: RootDocument,
+})
+
+function RootDocument({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <head>
+        {/** biome-ignore lint/security/noDangerouslySetInnerHtml: anti-FOUC theme script */}
+        <script dangerouslySetInnerHTML={{ __html: themeScript }} />
+        <HeadContent />
+      </head>
+      <body>
+        {children}
+        <TanStackDevtools
+          config={{
+            position: 'bottom-right',
+          }}
+          plugins={[
+            {
+              name: 'Tanstack Router',
+              render: <TanStackRouterDevtoolsPanel />,
+            },
+          ]}
+        />
+        <Scripts />
+      </body>
+    </html>
+  )
+}

package/templates/tanstack/router.no-trpc.tsx

@@ -0,0 +1,24 @@
+import { createRouter as createTanStackRouter } from '@tanstack/react-router'
+import type { ReactNode } from 'react'
+import { ThemeProvider } from './components/theme-provider'
+import { routeTree } from './routeTree.gen'
+
+export function getRouter() {
+  const router = createTanStackRouter({
+    routeTree,
+    scrollRestoration: true,
+    defaultPreload: 'intent',
+
+    Wrap: (props: { children: ReactNode }) => (
+      <ThemeProvider defaultTheme="system">{props.children}</ThemeProvider>
+    ),
+  })
+
+  return router
+}
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: ReturnType<typeof getRouter>
+  }
+}