@alfredmouelle/create-stack 0.1.0 → 0.1.2

package/README.md

@@ -1,56 +1,117 @@
 # create-stack
 
-Interactive, **deterministic** installer for the reference stack — the non-LLM
-counterpart of the `bootstrap` skill's CREATE mode. It forks a base app
-(`apps/tanstack-base` or `apps/next-base`) and strips it down to your selection.
+> `@alfredmouelle/create-stack`
 
-## Usage
+Interactive, **deterministic** project installer. It forks a fully-wired base app
+(**Next.js App Router** or **TanStack Start**) and strips it down to exactly the
+foundations and provider you pick — Drizzle, tRPC, better-auth, data tables and a
+mailer — then stamps identity, generates `.env`, initializes git and verifies the
+result (typecheck + Biome).
+
+No template guesswork: the output is a real, buildable app from day one.
+
+## Quick start
 
 ```bash
-# from anywhere
-node /path/to/stack/cli/index.mjs my-app
+pnpm dlx @alfredmouelle/create-stack my-app
+# or, using the create-* convention:
+pnpm create @alfredmouelle/stack my-app
+# npm / yarn:
+npm create @alfredmouelle/stack my-app
+yarn create @alfredmouelle/stack my-app
+```
+
+Run with no extra flags → an **interactive wizard** asks every question. Pass any
+selection flag → **non-interactive** mode (scriptable / CI).
+
+## Requirements
+
+- **Node** ≥ 22
+- **pnpm** (the generated project is a pnpm project)
+- **git** and **rsync** available on `PATH` (macOS/Linux ship both)
 
-# from the stack repo
-pnpm create-stack my-app
+## Usage
+
+```
+create-stack [project] [flags]
 ```
 
-The wizard asks for:
+`project` is the target directory (and default package name). It must be empty or
+not exist yet. In non-interactive mode it is required.
+
+### Flags
+
+| Flag | Values | Default | Description |
+| --- | --- | --- | --- |
+| `--framework` | `tanstack` \| `next` | `tanstack` | Base app to fork. |
+| `--foundations` | csv of `drizzle,trpc,better-auth,data-table` | all | Foundations to keep; the rest are stripped. |
+| `--mailer` | `resend` \| `brevo` \| `ses` \| `none` | `resend` | Mailer provider. `none` is rejected when `better-auth` is kept. |
+| `--no-install` | — | install on | Skip `pnpm install` + verification. |
+| `--yes`, `-y` | — | — | Non-interactive with all defaults. |
+
+Passing any of `--framework`, `--foundations`, `--mailer` or `--no-install`
+(or `--yes`) switches the CLI to non-interactive mode; missing values fall back
+to the defaults above.
 
-- **Framework** — TanStack Start or Next.js (App Router)
-- **Foundations** — Drizzle, tRPC, better-auth, data-table (hard deps resolved:
-  tRPC/better-auth ⇒ Drizzle; better-auth ⇒ mailer)
-- **Mailer provider** — Resend, Brevo, Amazon SES (or none, if no better-auth)
-- **Extra capabilities** — storage, jobs, cache, … (added afterwards via the
-  `add-capability` skill; not baked into the base)
+### Dependency resolution
 
-Then it forks, strips unselected foundations, swaps the mailer adapter, stamps
-identity, generates `.env(.example)`, and optionally installs + verifies
-(typecheck + Biome).
+Selections are normalized for you:
 
-## How it works
+- `trpc` ⇒ pulls in `drizzle`
+- `better-auth` ⇒ pulls in `drizzle` **and** forces a real mailer (not `none`)
 
-- **Single source of truth**: the base apps (`apps/*-base`) hold the real code;
-  the `patterns/*/pattern.json` manifests drive deps/scripts/env/file lists.
-- **Deterministic strip**: whole-directory deletes + dep/env/script diffs from the
-  manifests, plus a few hardcoded code *seams* (tRPC↔auth context, root provider
-  wiring) handled via shipped reduced variants in `templates/`.
-- If you edit a seam file in a base app (`server/api/trpc.ts`, the root
-  `router.tsx` / `__root.tsx` / `layout.tsx`, the schema barrel), update the
-  matching transform in `lib/strip.mjs` or the `templates/` variant.
+### Examples
 
-## Layout
+```bash
+# Full interactive wizard
+pnpm dlx @alfredmouelle/create-stack my-app
+
+# Everything, defaults (TanStack Start + all foundations + Resend), no questions
+pnpm dlx @alfredmouelle/create-stack my-app --yes
 
+# Next.js with just Drizzle + tRPC, Amazon SES mailer, don't install
+pnpm dlx @alfredmouelle/create-stack api --framework next \
+  --foundations drizzle,trpc --mailer ses --no-install
+
+# Minimal: Drizzle only, no mailer
+pnpm dlx @alfredmouelle/create-stack db-svc --foundations drizzle --mailer none
 ```
-cli/
-  index.mjs          wizard (prompts) + install/verify + report
-  lib/
-    build.mjs        pure build phase (fork → strip → mailer → env → identity)
-    manifests.mjs    load patterns + capabilities; logical→manifest mapping
-    scaffold.mjs     fork base app, make it standalone
-    strip.mjs        reverse-strip unselected foundations + code seams
-    mailer.mjs       mailer provider swap
-    env.mjs          rebuild src/env.ts blocks + generate .env files
-    identity.mjs     title/meta + README with the # Author footer
-    util.mjs         fs / exec / package.json helpers
-  templates/         reduced "no-trpc" root-wiring variants
+
+## What you get
+
+- **Framework** — Next.js App Router *or* TanStack Start, fully wired (SSR, routing).
+- **Drizzle ORM** — Postgres client, schema barrel, keyset pagination, seed harness.
+- **tRPC v11** — typed API, SSR/RSC integration, health router.
+- **better-auth** — email+password + verification, optional Google OAuth, session
+  guards, auth UI pages.
+- **Mailer** — Resend / Brevo / SES behind one port; React Email templates.
+- **Data tables** — TanStack Table primitives (DataTable, InfiniteDataTable, …).
+- **Baseline** — Tailwind v4 + shadcn, Geist, theme toggle, strict Biome, typed
+  env (`src/env.ts`), Dockerfile, a generated `.gitignore` and `.env`/`.env.example`.
+
+Unselected foundations are removed cleanly (files, deps, env vars and wiring),
+and the project is left **bootable and green** (typecheck + Biome).
+
+## Adding more capabilities
+
+The base bakes in the **mailer** (chosen via `--mailer`). Other capabilities —
+storage, jobs, cache, logger, analytics, error-tracking, http — are added *after*
+scaffolding with the `add-capability` skill (it wires each adapter's env/config per
+provider, which this CLI deliberately leaves out).
+
+## After scaffolding
+
+```bash
+cd my-app
+pnpm install            # only if you passed --no-install
+cp .env.example .env    # fill in the values
+pnpm dev
 ```
+
+## Notes
+
+- The published package is **self-contained**: the base apps, pattern manifests
+  and mailer adapters are bundled at publish time, so `pnpm dlx` needs nothing but
+  this package.
+- The generated project is a fresh git repo (`git init`, files staged) — make your
+  first commit when ready.

package/_stack/apps/next-base/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/_stack/apps/next-base/.vscode/settings.json

@@ -0,0 +1,35 @@
+{
+  "files.watcherExclude": {
+    "**/routeTree.gen.ts": true
+  },
+  "search.exclude": {
+    "**/routeTree.gen.ts": true
+  },
+  "files.readonlyInclude": {
+    "**/routeTree.gen.ts": true
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[css]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "editor.codeActionsOnSave": {
+    "source.organizeImports.biome": "explicit"
+  }
+}

package/_stack/apps/next-base/.zed/settings.json

@@ -0,0 +1,45 @@
+{
+  "lsp": {
+    "biome": {
+      "settings": {
+        "require_config_file": true,
+        "config_path": "biome.jsonc"
+      }
+    }
+  },
+
+  "languages": {
+    "Markdown": {
+      "formatter": { "language_server": { "name": "biome" } }
+    },
+    "JSONC": {
+      "formatter": { "language_server": { "name": "biome" } }
+    },
+    "JSON": {
+      "formatter": { "language_server": { "name": "biome" } }
+    },
+    "HTML": { "formatter": { "language_server": { "name": "biome" } } },
+    "CSS": { "formatter": { "language_server": { "name": "biome" } } },
+    "JavaScript": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "TypeScript": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "TSX": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    }
+  }
+}

package/_stack/apps/next-base/src/components/ui/spinner.tsx

@@ -2,7 +2,7 @@ import { Loader2 } from 'lucide-react'
 import type { ComponentProps } from 'react'
 import { cn } from '~/lib/utils'
 
-/** Loading indicator — the lucide `loader` icon, spinning. */
+/** Spinning lucide loader icon. */
 export function Spinner({ className, ...props }: ComponentProps<typeof Loader2>) {
   return <Loader2 aria-hidden="true" className={cn('size-4 animate-spin', className)} {...props} />
 }

package/_stack/apps/next-base/src/emails/components/components.tsx

@@ -1,3 +1,5 @@
+'use client'
+
 import { Body, Container, Head, Html, Link, Preview, Section, Tailwind, Text } from 'react-email'
 import { EmailThemeProvider, useEmailTheme } from './context'
 import { createEmailTheme, type EmailTheme, type EmailThemeOverride } from './theme'
@@ -5,9 +7,9 @@ import { createEmailTheme, type EmailTheme, type EmailThemeOverride } from './th
 export interface EmailLayoutProps {
   preview: string
   children: React.ReactNode
-  /** Per-email theme override, merged onto the default theme. */
+  /** Theme override, merged onto default. */
   theme?: EmailTheme | EmailThemeOverride
-  /** Footer year. Pass explicitly to keep rendered output deterministic. */
+  /** Footer year. Pass explicitly for deterministic output. */
   year?: number
 }
 

package/_stack/apps/next-base/src/emails/components/context.tsx

@@ -1,3 +1,5 @@
+'use client'
+
 import { createContext, useContext } from 'react'
 import { defaultTheme, type EmailTheme } from './theme'
 
@@ -12,7 +14,7 @@ export function EmailThemeProvider({ theme, children }: EmailThemeProviderProps)
   return <EmailThemeContext.Provider value={theme}>{children}</EmailThemeContext.Provider>
 }
 
-/** Read the active email theme. Falls back to {@link defaultTheme}. */
+/** Active email theme; falls back to {@link defaultTheme}. */
 export function useEmailTheme(): EmailTheme {
   return useContext(EmailThemeContext)
 }

package/_stack/apps/next-base/src/emails/components/theme.ts

@@ -1,13 +1,12 @@
 /**
- * The swappable design tokens for emails. Override any subset via
- * {@link createEmailTheme} and pass the result to `<EmailLayout theme={...}>`,
- * or wrap a tree in `<EmailThemeProvider>`.
+ * Swappable email design tokens. Override a subset via {@link createEmailTheme}
+ * and pass to `<EmailLayout theme={...}>`, or wrap in `<EmailThemeProvider>`.
  */
 export interface EmailTheme {
   brand: {
-    /** Shown in the header band and footer. */
+    /** Header band + footer. */
     name: string
-    /** Footer line (the year is prefixed automatically). */
+    /** Footer line (year prefixed automatically). */
     footer: string
   }
   fontFamily: string
@@ -21,7 +20,7 @@ export interface EmailTheme {
     border: string
     borderSubtle: string
     destructive: string
-    /** Text color on top of accent/destructive buttons. */
+    /** Text on accent/destructive buttons. */
     onAccent: string
   }
 }
@@ -52,7 +51,7 @@ export type EmailThemeOverride = {
   colors?: Partial<EmailTheme['colors']>
 }
 
-/** Deep-merge an override onto a base theme (defaults to {@link defaultTheme}). */
+/** Deep-merge override onto base (defaults to {@link defaultTheme}). */
 export function createEmailTheme(
   override: EmailThemeOverride = {},
   base: EmailTheme = defaultTheme,

package/_stack/apps/next-base/src/env.ts

@@ -1,13 +1,12 @@
 import { createEnv } from '@t3-oss/env-core'
 import * as v from 'valibot'
 
-/** Makes a var required only in production (optional in dev/test). */
+/** Required 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
+ * Typed env. Foundations + capabilities extend `server` and `runtimeEnv` with
  * the keys they need.
  */
 export const env = createEnv({

package/_stack/apps/next-base/src/lib/date.ts

@@ -1,4 +1,4 @@
 import { format } from 'date-fns'
 
-/** Format a Date as an ISO date string (yyyy-MM-dd). */
+/** Format Date as ISO date (yyyy-MM-dd). */
 export const toISODate = (date: Date): string => format(date, 'yyyy-MM-dd')

package/_stack/apps/next-base/src/server/auth/guards.ts

@@ -2,7 +2,7 @@ import 'server-only'
 import { redirect } from 'next/navigation'
 import { getSession } from '~/server/better-auth/server'
 
-/** Require a signed-in user in a Server Component / page; redirect otherwise. */
+/** Require signed-in user in a Server Component/page; else redirect. */
 export async function requireAuth() {
   const session = await getSession()
   if (!session) redirect('/auth/sign-in')

package/_stack/apps/next-base/src/server/better-auth/config.ts

@@ -36,7 +36,7 @@ export const auth = betterAuth({
   },
   socialProviders,
   user: {
-    // Extend the user with extra columns here (mirror them in auth.schema.ts):
+    // Extra user columns here (mirror in auth.schema.ts):
     // additionalFields: {
     //   role: { type: 'string', defaultValue: 'user', input: false },
     // },

package/_stack/apps/next-base/src/server/better-auth/server.ts

@@ -2,10 +2,10 @@ import { headers } from 'next/headers'
 import { cache } from 'react'
 import { auth } from '.'
 
-/** Per-request cached session lookup (uses the cookie cache). */
+/** Per-request cached session (uses cookie cache). */
 export const getSession = cache(async () => auth.api.getSession({ headers: await headers() }))
 
-/** Bypasses the cookie cache — use for sensitive checks. */
+/** Bypasses cookie cache; use for sensitive checks. */
 export const getFreshSession = cache(async () =>
   auth.api.getSession({
     headers: await headers(),

package/_stack/apps/next-base/src/server/db/schemas/index.ts

@@ -1,2 +1,2 @@
-// Barrel of every Drizzle schema. Add one `export *` line per `*.schema.ts`.
+// Drizzle schema barrel. One `export *` per `*.schema.ts`.
 export * from './auth.schema'

package/_stack/apps/next-base/src/server/db/seed.ts

@@ -3,11 +3,11 @@ import { config } from 'dotenv'
 
 config({ path: ['.env.local', '.env'] })
 
-// Deterministic data across runs.
+// Deterministic across runs.
 faker.seed(42)
 
 async function main() {
-  // Import the db client and seed your tables here (idempotent), using faker:
+  // Seed tables here (idempotent), via faker:
   //   const { db } = await import('~/server/db')
   //   await db.insert(user).values({
   //     id: faker.string.uuid(),

package/_stack/apps/next-base/src/server/email/adapters/resend/index.ts

@@ -4,7 +4,7 @@ import { formatAddress } from '../../core/address'
 import { type MailerAdapter, MailerError, type RenderedMessage } from '../../core/port'
 import { ResendConfigSchema } from './config'
 
-/** Minimal structural view of the Resend client we depend on (eases testing). */
+/** Structural view of the Resend client we depend on (eases testing). */
 export interface ResendClient {
   emails: {
     send(payload: ResendSendPayload): Promise<{
@@ -30,7 +30,7 @@ interface ResendSendPayload {
 
 export interface ResendAdapterOptions {
   apiKey: string
-  /** Inject a custom/mock client. Defaults to a real `Resend` instance. */
+  /** Inject a custom/mock client. Defaults to real `Resend`. */
   client?: ResendClient
 }
 
@@ -39,7 +39,7 @@ function toAttachmentContent(content: Uint8Array | string): Buffer | string {
 }
 
 export function resendAdapter(options: ResendAdapterOptions): MailerAdapter {
-  // Validate config early so a missing key fails at construction, not at send().
+  // Validate early so a missing key fails at construction, not send().
   const config = v.parse(ResendConfigSchema, { apiKey: options.apiKey })
   const client: ResendClient =
     options.client ?? (new Resend(config.apiKey) as unknown as ResendClient)

package/_stack/apps/next-base/src/server/email/core/address.ts

@@ -2,7 +2,7 @@ import type { MailAddress, MailRecipient } from './port'
 
 const ADDRESS_RE = /^\s*(.*?)\s*<([^>]+)>\s*$/
 
-/** Coerce a recipient into a structured {@link MailAddress}. */
+/** Coerce recipient to {@link MailAddress}. */
 export function normalizeAddress(input: MailRecipient): MailAddress {
   if (typeof input !== 'string') return input
   const match = input.match(ADDRESS_RE)
@@ -10,12 +10,12 @@ export function normalizeAddress(input: MailRecipient): MailAddress {
   return { email: input.trim() }
 }
 
-/** Coerce a single recipient or list into a normalized array. */
+/** Coerce recipient(s) to normalized array. */
 export function normalizeRecipients(input: MailRecipient | MailRecipient[]): MailAddress[] {
   return (Array.isArray(input) ? input : [input]).map(normalizeAddress)
 }
 
-/** Render an address back to an RFC-style string (`Name <email>`). */
+/** Render address to RFC string (`Name <email>`). */
 export function formatAddress(address: MailAddress): string {
   return address.name ? `${address.name} <${address.email}>` : address.email
 }

package/_stack/apps/next-base/src/server/email/core/port.ts

@@ -1,41 +1,37 @@
 import type { ReactElement } from 'react'
 
-/** A structured email address. */
+/** Structured email address. */
 export interface MailAddress {
   email: string
   name?: string
 }
 
-/**
- * A recipient, either as a plain string (`"hi@acme.com"` or
- * `"Acme <hi@acme.com>"`) or a structured {@link MailAddress}.
- */
+/** Recipient: string (`"hi@acme.com"` / `"Acme <hi@acme.com>"`) or {@link MailAddress}. */
 export type MailRecipient = string | MailAddress
 
 export interface MailAttachment {
   filename: string
-  /** Raw bytes or a base64 string. */
+  /** Raw bytes or base64 string. */
   content: Uint8Array | string
   contentType?: string
 }
 
 /**
- * A message as authored by application code. We never send raw HTML strings:
- * the body is always a React Email component, rendered to HTML + plain text by
- * the mailer before it reaches the adapter.
+ * Message authored by app code. Never raw HTML: body is a React Email
+ * component, rendered to HTML + text by the mailer before the adapter.
  */
 export interface MailMessage {
   to: MailRecipient | MailRecipient[]
   subject: string
-  /** A React Email component. Rendered to HTML and plain text automatically. */
+  /** React Email component; rendered to HTML + text automatically. */
   react: ReactElement
-  /** Overrides the default `from` configured on the mailer. */
+  /** Overrides the mailer's default `from`. */
   from?: MailRecipient
   replyTo?: MailRecipient
   cc?: MailRecipient | MailRecipient[]
   bcc?: MailRecipient | MailRecipient[]
   headers?: Record<string, string>
-  /** Provider-agnostic key/value tags for analytics & filtering. */
+  /** Provider-agnostic tags for analytics/filtering. */
   tags?: Record<string, string>
   attachments?: MailAttachment[]
 }
@@ -46,17 +42,14 @@ export interface SentMail {
 }
 
 /**
- * The port the application depends on. Swapping providers means swapping the
- * adapter passed to {@link createMailer}; this interface never changes.
+ * The port the app depends on. Swap providers by swapping the adapter passed
+ * to {@link createMailer}; this interface never changes.
  */
 export interface Mailer {
   send(message: MailMessage): Promise<SentMail>
 }
 
-/**
- * The message shape an adapter receives: addresses are normalized and the body
- * is already rendered to `html` + `text`. Adapters do no rendering.
- */
+/** Shape an adapter receives: addresses normalized, body pre-rendered to `html` + `text`. */
 export interface RenderedMessage {
   to: MailAddress[]
   from: MailAddress
@@ -71,13 +64,13 @@ export interface RenderedMessage {
   attachments?: MailAttachment[]
 }
 
-/** The contract each provider implements. Kept intentionally tiny. */
+/** Contract each provider implements. */
 export interface MailerAdapter {
   readonly name: string
   send(message: RenderedMessage): Promise<SentMail>
 }
 
-/** Normalized error thrown by adapters so callers never catch provider types. */
+/** Normalized adapter error so callers never catch provider types. */
 export class MailerError extends Error {
   readonly adapter: string
 

package/_stack/apps/next-base/src/server/email/core/render.ts

@@ -6,10 +6,10 @@ export interface RenderedBody {
   text: string
 }
 
-/** A function that turns a React Email component into HTML + plain text. */
+/** Turns a React Email component into HTML + text. */
 export type EmailRenderer = (react: ReactElement) => Promise<RenderedBody>
 
-/** Default renderer backed by `@react-email/render`. */
+/** Default renderer via `@react-email/render`. */
 export const renderEmail: EmailRenderer = async (react) => {
   const [html, text] = await Promise.all([render(react), render(react, { plainText: true })])
   return { html, text }

package/_stack/apps/next-base/src/server/email/factory.ts

@@ -3,21 +3,19 @@ import type { Mailer, MailerAdapter, MailRecipient, RenderedMessage } from './co
 import { type EmailRenderer, renderEmail } from './core/render'
 
 export interface CreateMailerOptions {
-  /** The provider implementation (Resend, Brevo, …). */
+  /** Provider implementation (Resend, Brevo, …). */
   adapter: MailerAdapter
-  /** Default sender used when a message omits `from`. */
+  /** Default sender when a message omits `from`. */
   from: MailRecipient
-  /** Override the React Email renderer (mostly for tests). */
+  /** Override the renderer (mostly for tests). */
   render?: EmailRenderer
 }
 
 /**
- * Build a {@link Mailer}. This is the composition root: pick the adapter here,
- * the rest of the app depends only on the `Mailer` port.
- *
- * The mailer renders the React body to HTML + plain text, normalizes every
- * address, applies the default sender, then hands a {@link RenderedMessage} to
- * the adapter.
+ * Build a {@link Mailer}. Composition root: pick the adapter here; the rest of
+ * the app depends only on the `Mailer` port. Renders the React body to
+ * HTML + text, normalizes addresses, applies the default sender, then hands a
+ * {@link RenderedMessage} to the adapter.
  */
 export function createMailer(options: CreateMailerOptions): Mailer {
   const defaultFrom = normalizeAddress(options.from)

package/_stack/apps/next-base/src/server/email/index.ts

@@ -11,7 +11,7 @@ function required(value: string | undefined, name: string): string {
   return value
 }
 
-// Lazy so the app boots without RESEND_API_KEY; the adapter is built on first send.
+// Lazy: app boots without RESEND_API_KEY; adapter built on first send.
 let mailer: Mailer | null = null
 function getMailer(): Mailer {
   if (!mailer) {

package/_stack/apps/next-base/src/trpc/react.tsx

@@ -13,10 +13,10 @@ import { createQueryClient } from './query-client'
 let clientQueryClientSingleton: QueryClient | undefined
 const getQueryClient = () => {
   if (typeof window === 'undefined') {
-    // Server: always make a new query client.
+    // Server: always new client.
     return createQueryClient()
   }
-  // Browser: reuse the same query client across renders.
+  // Browser: reuse across renders.
   clientQueryClientSingleton ??= createQueryClient()
   return clientQueryClientSingleton
 }

package/_stack/apps/next-base/src/trpc/server.ts

@@ -7,7 +7,7 @@ import { type AppRouter, createCaller } from '~/server/api/root'
 import { createTRPCContext } from '~/server/api/trpc'
 import { createQueryClient } from './query-client'
 
-/** Context for tRPC calls made from React Server Components. */
+/** Context for tRPC calls from RSCs. */
 const createContext = cache(async () => {
   const heads = new Headers(await headers())
   heads.set('x-trpc-source', 'rsc')

package/_stack/apps/tanstack-base/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ tsr generate && tsc --noEmit