@alfredmouelle/create-stack 0.1.1 → 0.2.0

package/lib/strip.mjs

@@ -1,43 +1,28 @@
-// 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.
+// Strip unselected foundations: whole-dir deletes + code-seam variants (trpc/auth).
 
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { foundationManifest } from './manifests.mjs'
+import { FOUNDATIONS, foundationDeps, foundationScripts } from './foundations.mjs'
+import { TEMPLATES } from './paths.mjs'
 import { copy, editFile, join, remove } from './util.mjs'
 
-const here = dirname(fileURLToPath(import.meta.url))
-const tpl = (rel) => join(here, '..', 'templates', rel)
+const tpl = (rel) => join(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 }) {
+/** @returns {{ removeDeps: string[], removeScripts: string[] }} */
+export function stripFoundations({ projectDir, framework, kept, keptMailer }) {
   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 keptDeps = new Set([...kept].flatMap((f) => foundationDeps(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)) {
+    for (const d of foundationDeps(f, framework)) {
       if (!keptDeps.has(d) && !ALWAYS_KEEP.has(d)) removeDeps.add(d)
     }
-    for (const s of Object.keys(m?.scripts ?? {})) removeScripts.add(s)
+    for (const s of foundationScripts(f)) removeScripts.add(s)
   }
 
   // --- data-table ---

package/lib/util.mjs

@@ -1,5 +1,4 @@
-// Small fs / exec / package.json helpers shared by the CLI modules.
-// No external deps — keep the CLI lean and instantly runnable.
+// fs / exec / package.json helpers shared by the CLI. No external deps.
 
 import { spawnSync } from 'node:child_process'
 import {
@@ -22,18 +21,18 @@ 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). */
+/** Remove file/dir if present (recursive, never throws on absent). */
 export const remove = (p) => {
   if (existsSync(p)) rmSync(p, { recursive: true, force: true })
 }
 
-/** Copy a file or directory tree. */
+/** Copy a file/dir 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. */
+/** Edit a file in place via (content) => content. No-op if absent. */
 export const editFile = (p, fn) => {
   if (!existsSync(p)) return false
   const next = fn(read(p))
@@ -41,20 +40,20 @@ export const editFile = (p, fn) => {
   return true
 }
 
-/** Is a directory empty (or absent)? Ignores common noise files. */
+/** Dir empty (or absent)? Ignores 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. */
+/** Run a command (inherits stdio). 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. */
+/** Run a command, capturing trimmed stdout. '' on failure. */
 export const runCapture = (cmd, args, opts = {}) => {
   const res = spawnSync(cmd, args, { encoding: 'utf8', ...opts })
   return res.status === 0 ? (res.stdout || '').trim() : ''
@@ -62,7 +61,7 @@ export const runCapture = (cmd, args, opts = {}) => {
 
 export { join }
 
-// --- package.json helpers (operate on a parsed object, mutate in place) ---
+// --- package.json helpers (mutate parsed object in place) ---
 
 export const pkgRemoveDeps = (pkg, names) => {
   for (const field of ['dependencies', 'devDependencies']) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfredmouelle/create-stack",
-  "version": "0.1.1",
+  "version": "0.2.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": {

package/_stack/packages/mailer/capability.json

@@ -1,28 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "mailer",
-  "description": "Transactional email. Bodies are always React Email components, rendered to HTML + plain text.",
-  "port": "src/core/port.ts",
-  "factory": "src/factory.ts",
-  "defaultAdapter": "resend",
-  "adapters": {
-    "resend": {
-      "deps": ["resend"],
-      "env": ["RESEND_API_KEY"],
-      "files": ["src/adapters/resend"]
-    },
-    "brevo": {
-      "deps": ["@getbrevo/brevo"],
-      "env": ["BREVO_API_KEY"],
-      "files": ["src/adapters/brevo"]
-    },
-    "ses": {
-      "deps": ["@aws-sdk/client-sesv2"],
-      "env": ["AWS_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"],
-      "files": ["src/adapters/ses"]
-    }
-  },
-  "sharedDeps": ["valibot", "@react-email/render"],
-  "peerDeps": ["react", "react-dom"],
-  "sharedFiles": ["src/core", "src/factory.ts", "src/index.ts"]
-}

package/_stack/patterns/README.md

@@ -1,58 +0,0 @@
-# Patterns
-
-Foundational, framework-coupled **patterns** the `bootstrap` skill vendors into a
-freshly scaffolded app — the counterpart to `packages/` (swappable capabilities).
-
-A *capability* is a provider behind a port (mailer, storage, …), swappable by
-changing one line. A *pattern* is a foundation you don't swap but always set up
-the same way: tRPC wiring, the better-auth instance, the Drizzle client. They are
-**framework-coupled** (currently `tanstack-start`, mirrored from the reference
-base apps) and depend on each other.
-
-**The code lives in the base apps, not here.** `patterns/` is a pure *manifest
-layer*: each `pattern.json` describes a foundation (how to detect it, its deps,
-env, framework, dependencies) and lists the files that make it up — by pointing
-**into the base apps** (`apps/tanstack-base`, `apps/next-base`), the single source
-of truth. No code is duplicated.
-
-Each pattern is `<name>/pattern.json` (see `../pattern.schema.json`).
-`_baseline/` is special: real always-applied config files (Biome, tsconfig, env
-skeleton, the `# Author` README footer) that a standalone fork needs but the base
-apps don't carry on their own (they inherit the monorepo's Biome).
-
-## How the skills use these
-
-The manifests drive two flows:
-
-- **bootstrap — create mode** (empty folder): fork a base app, then *strip* every
-  foundation/capability the user didn't pick, using each manifest's `files`/`deps`/
-  `env` to know its exact footprint.
-- **bootstrap — existing project / add-capability**: match each manifest's `detect`
-  against the project → the opt-in set, then *vendor* the listed files (copied from
-  the base apps) + deps + env, wire `integratesWith` when both sides are opt-in, and
-  pull required `capabilities`. A pattern not referenced is never pulled.
-
-## Available patterns
-
-- **drizzle** — Drizzle ORM + drizzle-kit (Postgres). Client, schema barrel,
-  cursor pagination, seed harness.
-- **better-auth** — better-auth v1 with the Drizzle adapter. Email+password,
-  verification, optional Google OAuth, rate limiting, auth tables, client +
-  session helpers, route guard. `dependsOn` drizzle; needs the mailer + email-kit
-  capabilities.
-- **trpc** — tRPC v11 + TanStack React Query. Context, procedure tiers, error
-  formatter, client + SSR caller, fetch handler. `dependsOn` drizzle,
-  `integratesWith` better-auth.
-- **data-table** — headless tables with TanStack Table (table + skeleton
-  primitives, DataTable, InfiniteDataTable, SortableHeader). `framework: agnostic`
-  — works in both Next and TanStack Start.
-
-Next.js variants (App Router) of the framework-coupled patterns:
-
-- **better-auth-next** — better-auth with `next/headers` session, `toNextJsHandler`
-  catch-all, server-component guards (`requireAuth`).
-- **trpc-next** — tRPC with the classic `api.x.useQuery` hooks (createTRPCReact) +
-  RSC hydration. `integratesWith` better-auth-next.
-
-bootstrap picks the variant matching the project's framework: `trpc`/`better-auth`
-for TanStack Start, `trpc-next`/`better-auth-next` for Next.

package/_stack/patterns/_baseline/env.ts

@@ -1,31 +0,0 @@
-import { createEnv } from '@t3-oss/env-core';
-import * as v from 'valibot';
-
-/** Makes a var required only in production (optional in dev/test). */
-export const requiredInProduction = <T extends v.GenericSchema>(schema: T) =>
-  process.env.NODE_ENV === 'production' ? schema : v.optional(schema);
-
-/**
- * Typed environment. Start minimal — patterns (drizzle, better-auth, …) and
- * capabilities (add-capability) extend the `server` block and `runtimeEnv` with
- * the keys they need.
- */
-export const env = createEnv({
-  shared: {
-    NODE_ENV: v.optional(
-      v.picklist(['development', 'test', 'production']),
-      'development',
-    ),
-  },
-
-  server: {
-    // Extended by patterns/capabilities (DATABASE_URL, BETTER_AUTH_SECRET, …).
-  },
-
-  runtimeEnv: {
-    NODE_ENV: process.env.NODE_ENV,
-  },
-
-  skipValidation: !!process.env.SKIP_ENV_VALIDATION,
-  emptyStringAsUndefined: true,
-});

package/_stack/patterns/_baseline/tsconfig.json

@@ -1,27 +0,0 @@
-{
-  "include": ["**/*.ts", "**/*.tsx"],
-  "compilerOptions": {
-    "target": "ES2022",
-    "jsx": "react-jsx",
-    "module": "ESNext",
-    "paths": {
-      "~/*": ["./src/*"]
-    },
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "types": ["vite/client"],
-
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    /* Linting */
-    "skipLibCheck": true,
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true
-  }
-}

package/_stack/patterns/better-auth/pattern.json

@@ -1,73 +0,0 @@
-{
-  "$schema": "../../pattern.schema.json",
-  "name": "better-auth",
-  "description": "better-auth v1 with the Drizzle adapter (Postgres). Email+password, email verification, optional Google OAuth, rate limiting and TanStack Start cookies. Ships auth tables, server/client instances, session helpers and a route guard.",
-  "framework": "tanstack-start",
-  "detect": {
-    "deps": [
-      "better-auth"
-    ],
-    "files": []
-  },
-  "dependsOn": [
-    "drizzle"
-  ],
-  "integratesWith": [
-    "trpc"
-  ],
-  "capabilities": [
-    "mailer",
-    "email-kit"
-  ],
-  "deps": [
-    "better-auth"
-  ],
-  "env": [
-    "BETTER_AUTH_URL",
-    "BETTER_AUTH_SECRET",
-    "BETTER_AUTH_GOOGLE_CLIENT_ID",
-    "BETTER_AUTH_GOOGLE_CLIENT_SECRET"
-  ],
-  "files": [
-    {
-      "from": "apps/tanstack-base/src/server/better-auth/config.ts",
-      "to": "<srcRoot>/server/better-auth/config.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/better-auth/client.ts",
-      "to": "<srcRoot>/server/better-auth/client.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/better-auth/session.ts",
-      "to": "<srcRoot>/server/better-auth/session.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/better-auth/emails.tsx",
-      "to": "<srcRoot>/server/better-auth/emails.tsx"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/better-auth/index.ts",
-      "to": "<srcRoot>/server/better-auth/index.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/db/schemas/auth.schema.ts",
-      "to": "<srcRoot>/server/db/schemas/auth.schema.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/routes/api/auth/$.ts",
-      "to": "<srcRoot>/routes/api/auth/$.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/routes/_authed.tsx",
-      "to": "<srcRoot>/routes/_authed.tsx"
-    }
-  ],
-  "wiring": [
-    "Append `export * from './auth.schema'` to <srcRoot>/server/db/schemas/index.ts (created by the drizzle pattern).",
-    "emails.tsx imports ~/server/email (mailer capability) and ~/emails/{reset-password,verify-email} (email-kit). Ensure both capabilities are added; create the two templates if missing."
-  ],
-  "notes": [
-    "Auth tables (user/session/account/verification) live in auth.schema.ts; better-auth manages them via the Drizzle adapter. Add custom user columns via `additionalFields` in config.ts mirrored in auth.schema.ts.",
-    "BETTER_AUTH_SECRET is read implicitly from env by better-auth; the rest are validated in env.ts."
-  ]
-}

package/_stack/patterns/better-auth-next/pattern.json

@@ -1,76 +0,0 @@
-{
-  "$schema": "../../pattern.schema.json",
-  "name": "better-auth-next",
-  "description": "better-auth v1 for Next.js App Router with the Drizzle adapter. Email+password + verification, optional Google OAuth, session via next/headers (react cache), toNextJsHandler catch-all route, and server-component guards. The Next counterpart of the `better-auth` pattern.",
-  "framework": "next",
-  "detect": {
-    "deps": [
-      "better-auth"
-    ],
-    "files": [
-      "src/app/api/auth/[...all]/route.ts"
-    ]
-  },
-  "dependsOn": [
-    "drizzle"
-  ],
-  "integratesWith": [
-    "trpc-next"
-  ],
-  "capabilities": [
-    "mailer",
-    "email-kit"
-  ],
-  "deps": [
-    "better-auth"
-  ],
-  "env": [
-    "BETTER_AUTH_URL",
-    "BETTER_AUTH_SECRET",
-    "BETTER_AUTH_GOOGLE_CLIENT_ID",
-    "BETTER_AUTH_GOOGLE_CLIENT_SECRET"
-  ],
-  "files": [
-    {
-      "from": "apps/next-base/src/server/better-auth/config.ts",
-      "to": "<srcRoot>/server/better-auth/config.ts"
-    },
-    {
-      "from": "apps/next-base/src/server/better-auth/client.ts",
-      "to": "<srcRoot>/server/better-auth/client.ts"
-    },
-    {
-      "from": "apps/next-base/src/server/better-auth/server.ts",
-      "to": "<srcRoot>/server/better-auth/server.ts"
-    },
-    {
-      "from": "apps/next-base/src/server/better-auth/emails.tsx",
-      "to": "<srcRoot>/server/better-auth/emails.tsx"
-    },
-    {
-      "from": "apps/next-base/src/server/better-auth/index.ts",
-      "to": "<srcRoot>/server/better-auth/index.ts"
-    },
-    {
-      "from": "apps/next-base/src/server/auth/guards.ts",
-      "to": "<srcRoot>/server/auth/guards.ts"
-    },
-    {
-      "from": "apps/next-base/src/server/db/schemas/auth.schema.ts",
-      "to": "<srcRoot>/server/db/schemas/auth.schema.ts"
-    },
-    {
-      "from": "apps/next-base/src/app/api/auth/[...all]/route.ts",
-      "to": "<srcRoot>/app/api/auth/[...all]/route.ts"
-    }
-  ],
-  "wiring": [
-    "Append `export * from './auth.schema'` to <srcRoot>/server/db/schemas/index.ts (created by the drizzle pattern).",
-    "emails.tsx imports ~/server/email (mailer) and ~/emails/{reset-password,verify-email} (email-kit) — add both capabilities and the two templates.",
-    "Auth pages live in app/auth/* (server pages) with forms in app/auth/_components/* ('use client', shadcn Form + react-hook-form + valibot)."
-  ],
-  "notes": [
-    "No tanstackStartCookies — cookies are handled by toNextJsHandler. getSession uses next/headers + react cache (server.ts). Protect Server Components/pages with requireAuth() from server/auth/guards.",
-    "Add custom user columns via `additionalFields` in config.ts mirrored in auth.schema.ts."
-  ]
-}

package/_stack/patterns/data-table/pattern.json

@@ -1,43 +0,0 @@
-{
-  "$schema": "../../pattern.schema.json",
-  "name": "data-table",
-  "description": "Headless data tables with TanStack Table: shadcn table + skeleton primitives, a DataTable (loading + empty states), an InfiniteDataTable and a SortableHeader.",
-  "framework": "agnostic",
-  "detect": {
-    "deps": [
-      "@tanstack/react-table"
-    ],
-    "files": []
-  },
-  "dependsOn": [],
-  "deps": [
-    "@tanstack/react-table"
-  ],
-  "env": [],
-  "files": [
-    {
-      "from": "apps/tanstack-base/src/components/ui/table.tsx",
-      "to": "<srcRoot>/components/ui/table.tsx"
-    },
-    {
-      "from": "apps/tanstack-base/src/components/ui/skeleton.tsx",
-      "to": "<srcRoot>/components/ui/skeleton.tsx"
-    },
-    {
-      "from": "apps/tanstack-base/src/components/data-table.tsx",
-      "to": "<srcRoot>/components/data-table.tsx"
-    },
-    {
-      "from": "apps/tanstack-base/src/components/infinite-data-table.tsx",
-      "to": "<srcRoot>/components/infinite-data-table.tsx"
-    },
-    {
-      "from": "apps/tanstack-base/src/components/sortable-header.tsx",
-      "to": "<srcRoot>/components/sortable-header.tsx"
-    }
-  ],
-  "notes": [
-    "Pure React + TanStack Table — works in both Next App Router and TanStack Start. Needs shadcn (cn util + Button); the table/skeleton primitives are vendored here.",
-    "On Next.js, the component that builds the table (calls useReactTable) must be a client component ('use client')."
-  ]
-}

package/_stack/patterns/drizzle/pattern.json

@@ -1,61 +0,0 @@
-{
-  "$schema": "../../pattern.schema.json",
-  "name": "drizzle",
-  "description": "Drizzle ORM + drizzle-kit (Postgres / node-postgres). DB client, schema barrel, cursor (keyset) pagination helpers and a seed harness.",
-  "framework": "tanstack-start",
-  "detect": {
-    "deps": [
-      "drizzle-orm"
-    ],
-    "files": [
-      "drizzle.config.ts"
-    ]
-  },
-  "dependsOn": [],
-  "deps": [
-    "drizzle-orm",
-    "pg"
-  ],
-  "devDeps": [
-    "drizzle-kit",
-    "dotenv",
-    "tsx",
-    "@types/pg",
-    "@faker-js/faker"
-  ],
-  "env": [
-    "DATABASE_URL"
-  ],
-  "scripts": {
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:push": "drizzle-kit push",
-    "db:studio": "drizzle-kit studio",
-    "db:seed": "tsx src/server/db/seed.ts"
-  },
-  "files": [
-    {
-      "from": "apps/tanstack-base/drizzle.config.ts",
-      "to": "drizzle.config.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/db/index.ts",
-      "to": "<srcRoot>/server/db/index.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/db/keyset.ts",
-      "to": "<srcRoot>/server/db/keyset.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/db/seed.ts",
-      "to": "<srcRoot>/server/db/seed.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/db/schemas/index.ts",
-      "to": "<srcRoot>/server/db/schemas/index.ts"
-    }
-  ],
-  "notes": [
-    "drizzle.config.ts globs ./src/server/db/schemas/*.schema.ts — adjust the path if the project's source root is not ./src."
-  ]
-}

package/_stack/patterns/trpc/pattern.json

@@ -1,61 +0,0 @@
-{
-  "$schema": "../../pattern.schema.json",
-  "name": "trpc",
-  "description": "tRPC v11 + TanStack React Query. Context with session injection, public/protected procedures, valibot error formatter, batch-stream client, SSR caller and a fetch route handler.",
-  "framework": "tanstack-start",
-  "detect": {
-    "deps": [
-      "@trpc/server"
-    ],
-    "files": []
-  },
-  "dependsOn": [
-    "drizzle"
-  ],
-  "integratesWith": [
-    "better-auth"
-  ],
-  "deps": [
-    "@trpc/server",
-    "@trpc/client",
-    "@trpc/tanstack-react-query",
-    "@tanstack/react-query",
-    "superjson",
-    "valibot"
-  ],
-  "env": [],
-  "files": [
-    {
-      "from": "apps/tanstack-base/src/server/api/trpc.ts",
-      "to": "<srcRoot>/server/api/trpc.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/api/root.ts",
-      "to": "<srcRoot>/server/api/root.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/server/api/routers/health.router.ts",
-      "to": "<srcRoot>/server/api/routers/health.router.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/routes/api.trpc.$.tsx",
-      "to": "<srcRoot>/routes/api.trpc.$.tsx"
-    },
-    {
-      "from": "apps/tanstack-base/src/trpc/react.tsx",
-      "to": "<srcRoot>/trpc/react.tsx"
-    },
-    {
-      "from": "apps/tanstack-base/src/trpc/query-client.ts",
-      "to": "<srcRoot>/trpc/query-client.ts"
-    },
-    {
-      "from": "apps/tanstack-base/src/trpc/server.ts",
-      "to": "<srcRoot>/trpc/server.ts"
-    }
-  ],
-  "notes": [
-    "trpc.ts integrates with better-auth: it imports `auth` and injects `session` into the context. If the better-auth pattern is NOT opt-in, strip those imports, the `session` from the context, and protectedProcedure — keep publicProcedure + the timing middleware.",
-    "Wire TRPCReactProvider + createQueryClient into the app's root route, and getServerHelpers for SSR preloading (see tanstack-base's router for the exact root wiring)."
-  ]
-}

package/_stack/patterns/trpc-next/pattern.json

@@ -1,64 +0,0 @@
-{
-  "$schema": "../../pattern.schema.json",
-  "name": "trpc-next",
-  "description": "tRPC v11 for Next.js App Router — the classic `api.x.useQuery` / `useMutation` hooks (createTRPCReact) plus RSC hydration (createHydrationHelpers). The Next counterpart of the `trpc` pattern.",
-  "framework": "next",
-  "detect": {
-    "deps": [
-      "@trpc/react-query"
-    ],
-    "files": []
-  },
-  "dependsOn": [
-    "drizzle"
-  ],
-  "integratesWith": [
-    "better-auth-next"
-  ],
-  "deps": [
-    "@trpc/server",
-    "@trpc/client",
-    "@trpc/react-query",
-    "@tanstack/react-query",
-    "superjson",
-    "valibot"
-  ],
-  "env": [],
-  "files": [
-    {
-      "from": "apps/next-base/src/server/api/trpc.ts",
-      "to": "<srcRoot>/server/api/trpc.ts"
-    },
-    {
-      "from": "apps/next-base/src/server/api/root.ts",
-      "to": "<srcRoot>/server/api/root.ts"
-    },
-    {
-      "from": "apps/next-base/src/server/api/routers/health.router.ts",
-      "to": "<srcRoot>/server/api/routers/health.router.ts"
-    },
-    {
-      "from": "apps/next-base/src/trpc/react.tsx",
-      "to": "<srcRoot>/trpc/react.tsx"
-    },
-    {
-      "from": "apps/next-base/src/trpc/query-client.ts",
-      "to": "<srcRoot>/trpc/query-client.ts"
-    },
-    {
-      "from": "apps/next-base/src/trpc/server.ts",
-      "to": "<srcRoot>/trpc/server.ts"
-    },
-    {
-      "from": "apps/next-base/src/app/api/trpc/[trpc]/route.ts",
-      "to": "<srcRoot>/app/api/trpc/[trpc]/route.ts"
-    }
-  ],
-  "wiring": [
-    "Wrap the app in <TRPCReactProvider> in app/layout.tsx (it's a client component)."
-  ],
-  "notes": [
-    "Client usage: `api.<router>.<proc>.useQuery()` / `.useMutation()` from ~/trpc/react. RSC usage: `import { api, HydrateClient } from '~/trpc/server'` for prefetch + hydrate.",
-    "trpc.ts context calls better-auth getSession; if better-auth-next is NOT opt-in, strip the auth import, `session` from the context, and protectedProcedure."
-  ]
-}