@alfredmouelle/create-stack 0.1.1 → 0.2.0

package/README.md

@@ -4,9 +4,10 @@
 
 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).
+foundations and provider you pick — Drizzle, tRPC, better-auth, data tables, a
+mailer and optional capabilities (storage, cache, jobs, logger, analytics,
+error-tracking) — 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.
 
@@ -46,13 +47,20 @@ not exist yet. In non-interactive mode it is required.
 | `--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. |
-| `--caps` | csv of capability names | — | Extra capabilities to add afterwards via `add-capability` (see below). |
+| `--storage` | `s3` \| `r2` \| `gcs` \| `local` | `s3` | Object storage capability (omit to skip). |
+| `--cache` | `redis` \| `memory` | `redis` | Key/value cache capability (omit to skip). |
+| `--jobs` | `inngest` \| `trigger` \| `memory` | `inngest` | Background jobs capability (omit to skip). `inngest` also scaffolds the serve route. |
+| `--logger` | `pino` \| `console` | `pino` | Structured logging capability (omit to skip). |
+| `--analytics` | `posthog` \| `plausible` \| `noop` | `posthog` | Product analytics capability (omit to skip). |
+| `--error-tracking` | `sentry` \| `console` | `sentry` | Error reporting capability (omit to skip). |
 | `--no-install` | — | install on | Skip `pnpm install` + verification. |
 | `--yes`, `-y` | — | — | Non-interactive with all defaults. |
 
-Passing any of `--framework`, `--foundations`, `--mailer`, `--caps` or
-`--no-install` (or `--yes`) switches the CLI to non-interactive mode; missing
-values fall back to the defaults above.
+Each capability flag is optional: pass it (bare for the default adapter, or with a
+value) to vendor that capability; omit it to leave it out. Passing any selection
+flag — `--framework`, `--foundations`, `--mailer`, any capability, or `--no-install`
+(or `--yes`) — switches the CLI to non-interactive mode; missing values fall back to
+the defaults above.
 
 ### Dependency resolution
 
@@ -77,9 +85,9 @@ pnpm dlx @alfredmouelle/create-stack api --framework next \
 # Minimal: Drizzle only, no mailer
 pnpm dlx @alfredmouelle/create-stack db-svc --foundations drizzle --mailer none
 
-# TanStack + auth, and queue up extra capabilities for later
-pnpm dlx @alfredmouelle/create-stack app --foundations drizzle,trpc,better-auth \
-  --caps storage,jobs
+# With capabilities: R2 storage, Redis cache, Inngest jobs, Sentry errors
+pnpm dlx @alfredmouelle/create-stack my-app \
+  --storage r2 --cache --jobs --error-tracking
 ```
 
 ## What you get
@@ -97,12 +105,27 @@ pnpm dlx @alfredmouelle/create-stack app --foundations drizzle,trpc,better-auth
 Unselected foundations are removed cleanly (files, deps, env vars and wiring),
 and the project is left **bootable and green** (typecheck + Biome).
 
-## Extra capabilities
+## Capabilities
 
-`--caps` lists capabilities that aren't baked into the base (storage, jobs, cache,
-logger, analytics, error-tracking, http). They are **not** scaffolded by this CLI;
-the final report prints the follow-up to add them with the `add-capability` skill.
-Mailer is the exception — it's built in and chosen via `--mailer`.
+Beyond the **mailer** (always baked in, chosen via `--mailer`), the CLI can vendor
+any of the swappable capabilities at scaffold time — pick them in the wizard or via
+flags. Each is copied behind a port (into `src/server/<capability>/`) with a generated
+composition root that reads typed env and constructs the adapter lazily, so the app
+boots even before you fill in the keys:
+
+| Capability | Adapters | Notes |
+| --- | --- | --- |
+| `storage` | s3, r2, gcs, local | `getStorage()` accessor. |
+| `cache` | redis, memory | `getCache()` accessor. |
+| `jobs` | inngest, trigger, memory | `inngest` also scaffolds `serve.ts` + the framework route. |
+| `logger` | pino, console | `getLogger()` accessor. |
+| `analytics` | posthog, plausible, noop | `plausible` vendors `~/lib/http`. |
+| `error-tracking` | sentry, console | `getErrorTracking()` accessor. |
+
+Adapter deps and env keys are wired into `package.json` and `src/env.ts` automatically;
+cross-package imports (`@alfredmouelle/http`) are vendored into `src/lib/http` and
+rewritten. To add a capability to an **existing** project (or swap an adapter), use the
+`add-capability` skill.
 
 ## After scaffolding
 
@@ -115,8 +138,8 @@ 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 published package is **self-contained**: the base apps, the mailer adapters
+  and every capability package (`+ http`) 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

@@ -7,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

@@ -14,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

package/_stack/apps/tanstack-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/tanstack-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/tanstack-base/src/components/form/text-field.tsx

@@ -14,7 +14,7 @@ interface TextFieldProps extends NativeInputProps {
   field: AnyFieldApi
   label: string
   description?: string
-  /** Optional leading adornment (e.g. a lucide icon). */
+  /** Leading adornment (e.g. lucide icon). */
   icon?: ReactNode
 }