@withmata/blueprints 0.2.0

package/blueprints/features/db-drizzle-postgres/files/db/src/example-entity.ts

@@ -0,0 +1,73 @@
+// =============================================================================
+// Example Entity — Replace with your domain entity
+// =============================================================================
+// This file demonstrates the Drizzle schema patterns used in this project.
+// Copy this file for each new domain entity, then:
+//   1. Define your enums (if any)
+//   2. Define your table with columns and indexes
+//   3. Export $inferSelect / $inferInsert types
+//   4. Add the file path to drizzle/{{GROUP}}/drizzle.config.ts schema array
+//   5. Add the re-export to this group's index.ts
+//   6. Run `pnpm {{GROUP}}:generate` then `pnpm {{GROUP}}:migrate`
+// =============================================================================
+
+import {
+  index,
+  pgEnum,
+  pgTable,
+  text,
+  timestamp,
+  uuid,
+  varchar,
+} from "drizzle-orm/pg-core";
+
+// ============================================================================
+// Enums (optional — use pgEnum for PostgreSQL native enums)
+// ============================================================================
+
+export const exampleStatusEnum = pgEnum("example_status", [
+  "active",
+  "archived",
+]);
+
+// ============================================================================
+// Table
+// ============================================================================
+
+export const example = pgTable(
+  "example",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+
+    // CONFIGURE: Uncomment these if using the auth blueprint for user/org scoping
+    // userId: text("user_id").notNull(),
+    // organizationId: text("organization_id").notNull(),
+
+    name: varchar("name", { length: 200 }).notNull(),
+    description: text("description"),
+    status: exampleStatusEnum("status").default("active").notNull(),
+
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+    updatedAt: timestamp("updated_at")
+      .defaultNow()
+      .$onUpdate(() => new Date())
+      .notNull(),
+  },
+  (table) => [
+    index("example_name_idx").on(table.name),
+    index("example_status_idx").on(table.status),
+    // CONFIGURE: Add indexes for foreign key columns
+    // index("example_user_id_idx").on(table.userId),
+    // index("example_org_id_idx").on(table.organizationId),
+  ],
+);
+
+// ============================================================================
+// Type Exports
+// ============================================================================
+
+/** Type for a row read from the database (all columns). */
+export type Example = typeof example.$inferSelect;
+
+/** Type for inserting a new row (required columns only, optionals omitted). */
+export type NewExample = typeof example.$inferInsert;

package/blueprints/features/db-drizzle-postgres/files/db/src/index.ts

@@ -0,0 +1,8 @@
+// {{GROUP}} database schemas — barrel export
+// Each domain entity has its own file, re-exported here.
+//
+// CONFIGURE: Add re-exports for each new entity file you create.
+// After adding a new export here, also add the file to
+// drizzle/{{GROUP}}/drizzle.config.ts schema array.
+
+export * from "./example.js";

package/blueprints/features/db-drizzle-postgres/files/db/src/scripts/seed.ts

@@ -0,0 +1,50 @@
+// =============================================================================
+// Seed Script — Development Data
+// =============================================================================
+// Populates the {{GROUP}} database with sample data for development.
+//
+// Usage: pnpm seed
+// (runs via tsx, configured in packages/db/package.json)
+//
+// CONFIGURE: Replace the example inserts with your actual domain entities.
+// =============================================================================
+
+import { config } from "dotenv";
+import { drizzle } from "drizzle-orm/node-postgres";
+import pg from "pg";
+import { example } from "../{{GROUP}}/index.js";
+
+config({ path: "./.env" });
+
+const DATABASE_URL = process.env.{{GROUP_UPPER}}_DATABASE_URL;
+if (!DATABASE_URL) {
+  console.error("Missing {{GROUP_UPPER}}_DATABASE_URL in packages/db/.env");
+  process.exit(1);
+}
+
+async function seed() {
+  const pool = new pg.Pool({ connectionString: DATABASE_URL });
+  const db = drizzle(pool);
+
+  try {
+    console.log("Seeding {{GROUP}} database...\n");
+
+    const [record] = await db
+      .insert(example)
+      .values({
+        name: "Example Record",
+        description: "Created by seed script",
+      })
+      .returning();
+
+    console.log(`  Created example: "${record!.name}" (${record!.id})`);
+    console.log("\nDone!");
+  } finally {
+    await pool.end();
+  }
+}
+
+seed().catch((err) => {
+  console.error("Seed failed:", err);
+  process.exit(1);
+});

package/blueprints/features/db-drizzle-postgres/files/db/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "{{SCOPE}}/typescript-config/base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": true,
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "drizzle"]
+}

package/blueprints/features/tailwind-v4/BLUEPRINT.md

@@ -0,0 +1,29 @@
+# Tailwind v4 Blueprint — Full Design System Setup
+
+## Tier
+
+Feature
+
+## Status
+
+Planned.
+
+## Problem
+
+The foundation blueprint creates a minimal `config/tailwind-config/` package with basic theme tokens. Production apps need a complete design system: extended color palettes, dark mode strategy, animation utilities, typography scale, font loading, and component-friendly CSS custom properties. This blueprint extends the foundation's base into a full design system.
+
+## Intended Scope
+
+- Extended CSS custom properties and design tokens in `config/tailwind-config/`
+- Dark mode setup (class-based or media-query)
+- Animation utilities and keyframes
+- Typography scale and font loading (local + variable fonts)
+- Color palette generation using OKLCH color space
+- shadcn/ui-compatible token structure
+- Documentation of available tokens and usage patterns
+
+## Blueprint Dependencies
+
+| Blueprint | Type | Why |
+|-----------|------|-----|
+| `foundation/monorepo-turbo` | recommended | Provides the base `config/tailwind-config/` package with minimal theme tokens. Without it, this blueprint creates the config structure from scratch. Works in both monorepo and single-repo projects. |

package/blueprints/features/ui-shared-components/BLUEPRINT.md

@@ -0,0 +1,35 @@
+# UI Shared Components Blueprint — shadcn/ui + Monorepo
+
+## Tier
+
+Feature
+
+## Status
+
+Planned.
+
+## Problem
+
+Sharing UI components across multiple apps in a Turborepo monorepo requires careful package structure, export patterns, and styling integration. Without a standard setup, teams duplicate components, diverge on patterns, and fight build tooling issues.
+
+## Intended Scope
+
+- `packages/ui/` workspace package with shadcn/ui setup
+- Component export pattern via barrel `index.ts`
+- Consuming shared components from `apps/web/` and other apps
+- Integration with the shared Tailwind config from `config/tailwind-config/`
+- Component generation workflow (shadcn CLI adapted for monorepo)
+- Storybook setup (optional)
+
+## Blueprint Dependencies
+
+| Blueprint | Type | Why |
+|-----------|------|-----|
+| `features/tailwind-v4` | required | UI components depend on design tokens and theme setup from the Tailwind blueprint. Without it, components lack consistent styling. |
+| `foundation/monorepo-turbo` | recommended | Provides workspace structure, TypeScript config, and package conventions. Without it, the shared UI package is created as a local directory. |
+
+### If `tailwind-v4` is not installed
+
+The scaffold command should ask: "UI components need the Tailwind design system. Install tailwind-v4 first? (Y/n)"
+
+If declined, scaffold with basic Tailwind defaults and warn about missing design tokens.

package/blueprints/foundation/monorepo-turbo/BLUEPRINT.md

@@ -0,0 +1,378 @@
+# Monorepo Foundation Blueprint — Turborepo + pnpm
+
+## Tier
+
+Foundation — produces the project skeleton: monorepo structure, tooling configuration, shared config packages, and a minimal Next.js application shell.
+
+## Problem
+
+Setting up a production-ready Turborepo monorepo from scratch involves dozens of interconnected configuration decisions — workspace layout, TypeScript config hierarchy, linting/formatting, CSS tooling, environment variable validation, package exports, and dev tooling. Getting any of these wrong creates friction that compounds over the life of the project. This blueprint produces a working skeleton that feature blueprints can build on.
+
+## Status
+
+Complete.
+
+## Blueprint Dependencies
+
+None. Reads from discovery context if available, but does not require it.
+
+**Note:** This blueprint sets up a Turborepo monorepo. For single-repo applications (standalone Next.js, Node, or Bun apps), skip this blueprint and go directly to feature blueprints — they adapt to single-repo projects automatically.
+
+## Output
+
+This blueprint generates the project skeleton:
+
+```
+<project-root>/
+├── apps/
+│   └── web/                              # Next.js app (App Router)
+│       ├── app/
+│       │   ├── globals.css
+│       │   ├── layout.tsx
+│       │   └── page.tsx
+│       ├── env.ts                        # t3-env validation
+│       ├── next.config.ts
+│       ├── package.json
+│       ├── postcss.config.mjs
+│       └── tsconfig.json
+├── apis/                                 # Empty — backend blueprint adds server here
+├── config/
+│   ├── tailwind-config/                  # Shared Tailwind v4 styles
+│   │   ├── package.json
+│   │   ├── postcss.config.mjs
+│   │   └── shared-styles.css
+│   └── typescript-config/                # Shared TypeScript base configs
+│       ├── base.json
+│       ├── nextjs.json
+│       ├── package.json
+│       └── react-library.json
+├── packages/                             # Empty — feature blueprints add packages here
+├── .gitignore
+├── biome.json                            # Linting + formatting
+├── package.json                          # Root workspace scripts
+├── pnpm-workspace.yaml                   # Workspace patterns
+└── turbo.json                            # Task orchestration
+```
+
+**What's NOT created** (handled by feature blueprints):
+- `apis/server/` — backend/server feature blueprint
+- `packages/db/` — database feature blueprint
+- `packages/ui/` — UI component feature blueprint
+- `packages/api-client/` — backend feature blueprint
+
+---
+
+## Architecture
+
+### Monorepo Tool: Turborepo + pnpm
+
+- **pnpm workspaces** — Fast, disk-efficient, strict dependency isolation. Hoists shared deps while preventing phantom dependencies.
+- **Turborepo** — Task orchestration with dependency-aware caching. `dev` runs all workspaces in parallel. `build` respects dependency order via `^build`.
+- **Workspace protocol** — Internal deps use `workspace:*` for automatic linking. No manual version tracking between packages.
+
+### Linting & Formatting: Biome
+
+Single tool replacing both ESLint and Prettier. Faster, simpler configuration, fewer dependencies.
+
+- Formatter: 2-space indent, 80-char line width, double quotes, LF line endings
+- Linter: recommended rules with a11y warnings
+- Organizes imports automatically
+- Single `biome.json` at root covers the entire monorepo
+
+### TypeScript: Shared Config Package
+
+TypeScript configs live in `config/typescript-config/` as a workspace package. Every other package extends from it.
+
+- **`base.json`** — The foundation: strict mode, `noUncheckedIndexedAccess`, `NodeNext` modules, `ES2022` target
+- **`nextjs.json`** — Extends base for Next.js apps: `ESNext` modules, `Bundler` resolution, `jsx: preserve`, `noEmit`
+- **`react-library.json`** — Extends base for React packages: `jsx: react-jsx`
+
+### Tailwind CSS v4: Shared Config Package
+
+Tailwind v4 uses CSS-based configuration (no more `tailwind.config.js`). Shared styles live in `config/tailwind-config/` as a workspace package.
+
+- **`shared-styles.css`** — `@import "tailwindcss"`, `@theme inline` with CSS custom properties, light/dark theme tokens using OKLCH color space
+- Design tokens are set up for shadcn/ui compatibility (the UI feature blueprint extends this)
+- Each consuming app imports: `@import "{{SCOPE}}/tailwind-config"`
+
+### Module Resolution: Node.js Subpath Imports
+
+Uses the `#` prefix pattern via `package.json` `imports` field instead of `@/` tsconfig path aliases.
+
+```json
+{
+  "imports": {
+    "#auth/*": "./auth/*",
+    "#components/*": "./components/*"
+  }
+}
+```
+
+This is a Node.js native feature — works without bundler magic and is forward-compatible with all runtimes.
+
+### Environment Variables: t3-env + Zod
+
+Environment variables are validated at startup using `@t3-oss/env-nextjs` (client) or `@t3-oss/env-core` (server). Failed validation crashes immediately rather than failing at runtime.
+
+- `env.ts` is imported at app entry point (imported in `next.config.ts` for the web app)
+- Client vars prefixed with `NEXT_PUBLIC_`
+- Feature blueprints merge their env vars into the existing `env.ts`
+
+### Source-Based Packages
+
+Workspace packages that are consumed by Next.js can export TypeScript source directly (no build step for dev). Next.js transpiles them via `transpilePackages`. Packages deployed standalone (like an API server) still build to `dist/`.
+
+---
+
+## Naming Conventions
+
+| What | Convention | Example |
+|------|-----------|---------|
+| Files and directories | kebab-case | `use-organization.ts`, `brand-voices/` |
+| React components | PascalCase | `OrganizationProvider`, `MemberList` |
+| Functions and variables | camelCase | `createAuthClient`, `useHasPermission` |
+| TypeScript types/interfaces | PascalCase | `SessionUser`, `Organization` |
+| Environment variables | SCREAMING_SNAKE_CASE | `BETTER_AUTH_SECRET`, `NEXT_PUBLIC_API_URL` |
+| npm packages | `{{SCOPE}}/kebab-case` | `@myapp/db`, `@myapp/typescript-config` |
+| CSS custom properties | kebab-case | `--color-primary`, `--radius-lg` |
+| Database tables | snake_case | `user`, `organization`, `pipeline_runs` |
+| Database enums | snake_case | `company_size`, `industry` |
+
+### File Organization
+
+- **Prefer named exports** over default exports
+- **Co-locate related files** — tests, types, and schemas live next to their source
+- **Feature-based structure** — organize by feature/domain, not by file type
+- **Barrel exports** — each package exposes a clean public API via `index.ts`
+
+---
+
+## Folder Conventions
+
+### Workspace Layout
+
+```
+apps/       # Deployable applications (web frontends, marketing sites)
+apis/       # API servers (Hono, Express — added by backend feature blueprint)
+packages/   # Shared libraries (db, ui, api-client — added by feature blueprints)
+config/     # Shared configuration packages (typescript-config, tailwind-config)
+```
+
+### How Feature Blueprints Extend This
+
+| Feature Blueprint | Creates |
+|-------------------|---------|
+| Backend/Server | `apis/server/` with Hono setup, adds `transpilePackages` to Next.js |
+| Database | `packages/db/` with Drizzle config, schemas, connection helpers |
+| UI Components | `packages/ui/` with shadcn setup, extends tailwind-config |
+| Auth | Files across `apis/server/src/auth/`, `apps/web/auth/`, `packages/db/src/auth/` |
+
+### Inside apps/web/
+
+```
+apps/web/
+├── app/                    # Next.js App Router
+│   ├── (protected)/        # Route groups for auth-gated pages
+│   ├── auth/               # Auth flow pages (added by auth blueprint)
+│   ├── globals.css          # CSS entry point
+│   ├── layout.tsx           # Root layout
+│   └── page.tsx             # Home page
+├── auth/                   # Auth client code (added by auth blueprint)
+├── components/             # App-specific components
+├── hooks/                  # App-specific hooks
+├── types/                  # App-specific types
+├── env.ts                  # Environment validation
+├── next.config.ts
+├── package.json
+├── postcss.config.mjs
+└── tsconfig.json
+```
+
+---
+
+## What's Configurable
+
+| Choice | Default | Alternatives |
+|--------|---------|-------------|
+| npm scope | Derived from product name | Any valid npm scope |
+| Package manager | pnpm | bun (documented alternative) |
+| Node.js version | `>=22` | Any LTS version |
+
+**Note on bun:** If using bun instead of pnpm, replace `pnpm-workspace.yaml` with a `workspaces` field in root `package.json`, and update the `packageManager` field. The workspace protocol (`workspace:*`) works the same way.
+
+---
+
+## What's Opinionated
+
+These are locked-down decisions. The blueprint doesn't offer alternatives for these:
+
+- **pnpm** as package manager (bun documented as alternative, but npm and yarn are not supported)
+- **Turborepo** for monorepo task orchestration (not Nx, Lerna, or Rush)
+- **Biome** for linting + formatting (not ESLint + Prettier)
+- **Strict TypeScript** — `strict: true` and `noUncheckedIndexedAccess: true` in every package
+- **Next.js App Router** (not Pages Router)
+- **Tailwind CSS v4** with CSS-based configuration (not v3 with JS config)
+- **Node.js subpath imports** (`#prefix`) for internal module resolution (not `@/` tsconfig paths)
+- **`config/` as top-level dir** — shared configs are separate from `packages/`
+- **`workspace:*` protocol** for all internal dependencies
+- **t3-env + Zod** for environment variable validation
+- **Named exports** preferred over default exports
+- **Double quotes** for strings (configured in Biome)
+
+---
+
+## Expects from Discovery
+
+If product discovery was run first (`.claude/project-context.md` exists with a `## Product Discovery` section), the foundation blueprint reads:
+
+- **Product name** — used to derive the npm scope (e.g., "Acme Dashboard" → `@acme`)
+- **Technical constraints** — may influence Node.js version target or workspace complexity
+
+If no discovery was run, the foundation asks these questions directly.
+
+---
+
+## Dependencies
+
+### Root devDependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| `turbo` | `^2` | Monorepo task orchestration |
+| `@biomejs/biome` | `^2` | Linting + formatting |
+| `typescript` | `^5.9` | TypeScript compiler |
+| `tsx` | `^4` | TypeScript execution for scripts |
+| `@types/node` | `^22` | Node.js type definitions |
+
+### apps/web dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| `next` | `^15` | React framework |
+| `react` | `^19` | UI library |
+| `react-dom` | `^19` | React DOM renderer |
+| `@t3-oss/env-nextjs` | `^0.13` | Environment variable validation |
+| `zod` | `^3` | Schema validation (used by t3-env) |
+
+### apps/web devDependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| `tailwindcss` | `^4` | CSS framework |
+| `@tailwindcss/postcss` | `^4` | PostCSS plugin for Tailwind |
+| `typescript` | `^5.9` | TypeScript compiler |
+| `@types/react` | `^19` | React type definitions |
+| `@types/react-dom` | `^19` | React DOM type definitions |
+
+### config/tailwind-config dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| `tailwindcss` | `^4` | Tailwind CSS v4 |
+| `@tailwindcss/postcss` | `^4` | PostCSS integration |
+
+---
+
+## File Manifest
+
+| Blueprint File | Target Location | Description |
+|----------------|-----------------|-------------|
+| `files/root/package.json` | `package.json` | Root monorepo package.json with workspace scripts |
+| `files/root/turbo.json` | `turbo.json` | Turborepo task configuration |
+| `files/root/pnpm-workspace.yaml` | `pnpm-workspace.yaml` | Workspace patterns |
+| `files/root/biome.json` | `biome.json` | Biome linter + formatter config |
+| `files/root/gitignore` | `.gitignore` | Git ignore patterns |
+| `files/config/typescript-config/package.json` | `config/typescript-config/package.json` | TypeScript config package |
+| `files/config/typescript-config/base.json` | `config/typescript-config/base.json` | Base TypeScript config (strict) |
+| `files/config/typescript-config/nextjs.json` | `config/typescript-config/nextjs.json` | Next.js TypeScript config |
+| `files/config/typescript-config/react-library.json` | `config/typescript-config/react-library.json` | React library TypeScript config |
+| `files/config/tailwind-config/package.json` | `config/tailwind-config/package.json` | Tailwind config package |
+| `files/config/tailwind-config/shared-styles.css` | `config/tailwind-config/shared-styles.css` | Shared Tailwind v4 styles + theme |
+| `files/config/tailwind-config/postcss.config.mjs` | `config/tailwind-config/postcss.config.mjs` | PostCSS config for Tailwind |
+| `files/apps/web/package.json` | `apps/web/package.json` | Next.js app package.json |
+| `files/apps/web/tsconfig.json` | `apps/web/tsconfig.json` | Next.js TypeScript config |
+| `files/apps/web/next.config.ts` | `apps/web/next.config.ts` | Next.js configuration |
+| `files/apps/web/env.ts` | `apps/web/env.ts` | Environment variable validation |
+| `files/apps/web/postcss.config.mjs` | `apps/web/postcss.config.mjs` | PostCSS config for web app |
+| `files/apps/web/app/layout.tsx` | `apps/web/app/layout.tsx` | Root layout with font + metadata |
+| `files/apps/web/app/page.tsx` | `apps/web/app/page.tsx` | Home page placeholder |
+| `files/apps/web/app/globals.css` | `apps/web/app/globals.css` | CSS entry point |
+
+---
+
+## Integration Points
+
+- **npm scope** — Used by every feature blueprint for package names and imports (e.g., `{{SCOPE}}/db`, `{{SCOPE}}/typescript-config`)
+- **TypeScript configs** — Feature blueprints extend `{{SCOPE}}/typescript-config/base.json` (or `nextjs.json` / `react-library.json`)
+- **Tailwind config** — UI feature blueprint extends `{{SCOPE}}/tailwind-config` with additional component styles
+- **Workspace dirs** — Feature blueprints create new packages in `apis/`, `packages/` — foundation creates the empty dirs and workspace patterns
+- **Root scripts** — Feature blueprints add scripts to root `package.json` (e.g., `auth:generate`, `db:migrate`)
+- **Turbo tasks** — Feature blueprints add tasks to `turbo.json` (e.g., `auth:generate: { cache: false }`)
+- **Environment variables** — Feature blueprints merge their vars into `apps/web/env.ts` and add server-side env files
+- **project-context.md** — Feature blueprints read the Foundation section to determine npm scope, workspace layout
+
+---
+
+## Maintenance Hooks
+
+### Git Hooks (lefthook)
+
+The foundation blueprint includes a lefthook configuration for mechanical code quality enforcement. These run automatically on git actions — no AI involvement needed.
+
+**Pre-commit:**
+- Format staged files with Biome
+- Auto-fix and re-stage
+
+**Pre-push:**
+- Run typecheck across all workspaces
+
+The lefthook config is minimal by design. Feature blueprints may add their own checks (e.g., auth:generate verification).
+
+### Structural Hooks (for CLAUDE.md)
+
+| When you... | Then run... | Why |
+|---|---|---|
+| Add a new workspace package to `apps/`, `apis/`, `packages/`, or `config/` | Verify `pnpm-workspace.yaml` patterns cover it, then run `pnpm install` | New workspaces need to be discovered by pnpm |
+| Change a shared config package (`config/typescript-config/` or `config/tailwind-config/`) | Run `pnpm dev` and verify all consuming packages still build | Shared config changes cascade to all consumers |
+| Add a workspace dependency (e.g., `"@scope/ui": "workspace:*"`) | Run `pnpm install` then verify imports resolve | Workspace links need pnpm to wire them up |
+| Modify `turbo.json` task definitions | Verify `pnpm turbo run <task>` executes in the expected order | Task dependency changes affect build orchestration |
+| Change the TypeScript `base.json` config | Run typecheck across all workspaces: `pnpm turbo typecheck` | Base config changes affect every package |
+
+### Condensed Rules for CLAUDE.md
+```markdown
+### Monorepo maintenance
+- After every code change: format with Biome (`pnpm biome check --write .`) before considering work complete
+- After adding new workspace packages: verify `pnpm-workspace.yaml` patterns match, run `pnpm install`
+- After modifying shared configs (`config/typescript-config/`, `config/tailwind-config/`): verify all consumers still build
+- After changing `turbo.json`: verify task ordering with `pnpm turbo run <task> --dry`
+- After adding workspace dependencies: run `pnpm install` to create workspace links
+- Keep `turbo.json` tasks with `cache: false` for any task with side effects (migrations, code generation)
+```
+
+---
+
+## Project Context Output
+
+After completion, appends to `.claude/project-context.md`:
+
+```yaml
+## Foundation
+monorepo_tool: turborepo
+package_manager: pnpm
+npm_scope: "{{SCOPE}}"
+node_version: ">=22"
+workspaces:
+  apps: ["web"]
+  apis: []
+  packages: []
+  config: ["typescript-config", "tailwind-config"]
+framework: next.js (app router)
+typescript: strict
+linter: biome
+styling: tailwind-v4
+env_validation: t3-env + zod
+module_resolution: node subpath imports (#prefix)
+foundation_completed: <date>
+```
+
+

package/blueprints/foundation/monorepo-turbo/files/apps/web/app/globals.css

@@ -0,0 +1,2 @@
+@import "tailwindcss";
+@import "{{SCOPE}}/tailwind-config";

package/blueprints/foundation/monorepo-turbo/files/apps/web/app/layout.tsx

@@ -0,0 +1,23 @@
+import type { Metadata } from "next";
+import { Inter } from "next/font/google";
+import "./globals.css";
+
+// CONFIGURE: Replace with your preferred font
+const inter = Inter({ subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: "{{APP_NAME}}",
+  description: "",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={inter.className}>{children}</body>
+    </html>
+  );
+}

package/blueprints/foundation/monorepo-turbo/files/apps/web/app/page.tsx

@@ -0,0 +1,7 @@
+export default function Home() {
+  return (
+    <main className="flex min-h-screen items-center justify-center">
+      <h1 className="text-4xl font-bold">{{APP_NAME}}</h1>
+    </main>
+  );
+}

package/blueprints/foundation/monorepo-turbo/files/apps/web/env.ts

@@ -0,0 +1,13 @@
+import { createEnv } from "@t3-oss/env-nextjs";
+import { z } from "zod";
+
+export const env = createEnv({
+  client: {
+    NEXT_PUBLIC_FRONTEND_URL: z.string().url(),
+    // CONFIGURE: Feature blueprints add their env vars here
+    // e.g., NEXT_PUBLIC_API_URL for backend blueprint
+  },
+  runtimeEnv: {
+    NEXT_PUBLIC_FRONTEND_URL: process.env.NEXT_PUBLIC_FRONTEND_URL,
+  },
+});

package/blueprints/foundation/monorepo-turbo/files/apps/web/next.config.ts

@@ -0,0 +1,12 @@
+import type { NextConfig } from "next";
+
+// CONFIGURE: Import env.ts to validate environment variables at build time
+import "./env";
+
+const nextConfig: NextConfig = {
+  // CONFIGURE: Feature blueprints may add:
+  // - transpilePackages: ["{{SCOPE}}/api-client"] for source-based workspace packages
+  // - rewrites() for API proxy in production (cross-domain cookie support)
+};
+
+export default nextConfig;