@yosr-ai/template-next-fullstack 0.0.0-stage → 0.1.0-alpha.1

package/seed.template.json

@@ -0,0 +1,1721 @@
+{
+  "$schema": "../../../docs/engineering/schemas/seed.template.schema.json",
+  "schemaVersion": "0.1",
+  "name": "next-fullstack",
+  "version": "0.1.0-alpha.1",
+  "title": "Next.js full-stack (TypeScript)",
+  "description": "Prototype of Yosr Seed's first base template (Next.js + TypeScript, Tailwind + shadcn/ui, Vitest + Playwright smoke test). Implemented: base files with the ADR 0006 defaults, the orm-drizzle and orm-prisma overlays (database=postgres), database=none (base without either overlay), deploy=docker (standalone image, compose Postgres only when database=postgres), Auth.js, Clerk, tRPC, Stripe, and a recorded AI delta for domain-features. x-prototype.stubbedFeatures is empty. Dependency versions pinned from the npm registry on 2026-10-19 (Prisma adapter on 2026-10-28, Clerk on 2026-10-28, tRPC on 2026-10-29, Stripe on 2026-10-29).",
+  "license": "MIT",
+  "authors": [
+    "Yosr Seed"
+  ],
+  "keywords": [
+    "nextjs",
+    "typescript",
+    "tailwind",
+    "shadcn",
+    "postgres"
+  ],
+  "engines": {
+    "yosr": ">=0.1.0 <0.2.0",
+    "node": "^22.13.0 || ^24.0.0 || >=26.0.0"
+  },
+  "stack": {
+    "framework": "nextjs",
+    "language": "typescript",
+    "includes": [
+      "tailwindcss",
+      "shadcn-ui",
+      "vitest",
+      "playwright"
+    ]
+  },
+  "packageManagers": {
+    "default": "pnpm",
+    "supported": [
+      "pnpm",
+      "npm"
+    ]
+  },
+  "variables": {
+    "authLabel": {
+      "fromOption": "auth",
+      "map": {
+        "none": "none",
+        "authjs": "Auth.js",
+        "clerk": "Clerk"
+      }
+    },
+    "ormLabel": {
+      "fromOption": "orm",
+      "map": {
+        "prisma": "Prisma",
+        "drizzle": "Drizzle"
+      }
+    },
+    "storageLabel": {
+      "fromOption": "database",
+      "map": {
+        "none": "memory only (no database)",
+        "postgres": "Postgres"
+      }
+    },
+    "homeStorage": {
+      "fromOption": "database",
+      "map": {
+        "none": "kept in memory",
+        "postgres": "stored in Postgres"
+      }
+    }
+  },
+  "options": [
+    {
+      "id": "projectName",
+      "type": "string",
+      "label": {
+        "cli": "Project name",
+        "wizard": "What should we call your project?"
+      },
+      "help": {
+        "cli": "Lowercase, digits and dashes.",
+        "wizard": "A short name with no spaces. You can change the display name later."
+      },
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "maxLength": 64
+    },
+    {
+      "id": "database",
+      "type": "enum",
+      "label": {
+        "cli": "Database",
+        "wizard": "Does your app need to save data?"
+      },
+      "help": {
+        "cli": "Postgres, or none for a frontend/static-first app.",
+        "wizard": "Pick 'Yes' if the app stores things like users, posts or orders."
+      },
+      "default": "postgres",
+      "choices": [
+        {
+          "value": "none",
+          "label": {
+            "cli": "None",
+            "wizard": "No, it doesn't need to save data"
+          }
+        },
+        {
+          "value": "postgres",
+          "label": {
+            "cli": "Postgres",
+            "wizard": "Yes, save data in a Postgres database"
+          }
+        }
+      ]
+    },
+    {
+      "id": "orm",
+      "type": "enum",
+      "label": {
+        "cli": "Postgres ORM",
+        "wizard": "How should the app talk to its database?"
+      },
+      "help": {
+        "cli": "Only asked when database is Postgres.",
+        "wizard": "Both work well; Drizzle is the default."
+      },
+      "default": "drizzle",
+      "choices": [
+        {
+          "value": "drizzle",
+          "label": {
+            "cli": "Drizzle",
+            "wizard": "Drizzle (schema in TypeScript, lightweight)"
+          }
+        },
+        {
+          "value": "prisma",
+          "label": {
+            "cli": "Prisma",
+            "wizard": "Prisma (schema file, very popular)"
+          }
+        }
+      ],
+      "when": {
+        "option": "database",
+        "equals": "postgres"
+      }
+    },
+    {
+      "id": "auth",
+      "type": "enum",
+      "label": {
+        "cli": "Authentication",
+        "wizard": "Do people need to sign in?"
+      },
+      "default": "none",
+      "choices": [
+        {
+          "value": "none",
+          "label": {
+            "cli": "None",
+            "wizard": "No, anyone can use it"
+          }
+        },
+        {
+          "value": "authjs",
+          "label": {
+            "cli": "Auth.js",
+            "wizard": "Yes, and I want to host sign-in myself"
+          },
+          "help": {
+            "cli": "Self-hosted, database sessions via the chosen ORM. Requires database=postgres.",
+            "wizard": "Free and open source. Sign-in data lives in your own database, so it needs one."
+          }
+        },
+        {
+          "value": "clerk",
+          "label": {
+            "cli": "Clerk",
+            "wizard": "Yes, using a hosted sign-in service"
+          },
+          "help": {
+            "cli": "Hosted auth; works with or without a database. Requires a Clerk account and keys.",
+            "wizard": "Clerk handles sign-in screens and accounts for you. Needs a Clerk account; works even without a database."
+          }
+        }
+      ]
+    },
+    {
+      "id": "api",
+      "type": "enum",
+      "label": {
+        "cli": "API style",
+        "wizard": "How should the front end call the back end?"
+      },
+      "default": "server-actions",
+      "choices": [
+        {
+          "value": "server-actions",
+          "label": {
+            "cli": "Server actions",
+            "wizard": "Built-in Next.js server actions (simplest)"
+          }
+        },
+        {
+          "value": "trpc",
+          "label": {
+            "cli": "tRPC",
+            "wizard": "tRPC (typed API layer, good for larger apps)"
+          }
+        }
+      ]
+    },
+    {
+      "id": "payments",
+      "type": "boolean",
+      "label": {
+        "cli": "Add Stripe payments?",
+        "wizard": "Will you charge money in the app?"
+      },
+      "help": {
+        "cli": "Requires auth and database=postgres.",
+        "wizard": "Adds Stripe checkout. Needs sign-in and a database to remember who paid."
+      },
+      "default": false,
+      "when": {
+        "all": [
+          {
+            "not": {
+              "option": "auth",
+              "equals": "none"
+            }
+          },
+          {
+            "option": "database",
+            "equals": "postgres"
+          }
+        ]
+      }
+    },
+    {
+      "id": "deploy",
+      "type": "enum",
+      "label": {
+        "cli": "Deploy target",
+        "wizard": "Where will the app run?"
+      },
+      "default": "vercel",
+      "choices": [
+        {
+          "value": "vercel",
+          "label": {
+            "cli": "Vercel",
+            "wizard": "Vercel (easiest for Next.js)"
+          }
+        },
+        {
+          "value": "docker",
+          "label": {
+            "cli": "Docker",
+            "wizard": "Docker container (any server or cloud)"
+          }
+        }
+      ]
+    }
+  ],
+  "constraints": [
+    {
+      "id": "orm-requires-database",
+      "if": {
+        "not": {
+          "option": "database",
+          "equals": "postgres"
+        }
+      },
+      "then": {
+        "not": {
+          "option": "orm",
+          "in": [
+            "drizzle",
+            "prisma"
+          ]
+        }
+      },
+      "message": {
+        "cli": "--orm only applies with --database postgres.",
+        "wizard": "Choosing how to talk to the database only matters if you have one."
+      }
+    },
+    {
+      "id": "authjs-requires-database",
+      "if": {
+        "option": "auth",
+        "equals": "authjs"
+      },
+      "then": {
+        "option": "database",
+        "equals": "postgres"
+      },
+      "message": {
+        "cli": "--auth authjs requires --database postgres (database sessions). Use --auth clerk for auth without a database.",
+        "wizard": "Self-hosted sign-in needs a database. Turn on the database, or pick the hosted sign-in option."
+      }
+    },
+    {
+      "id": "payments-require-auth",
+      "if": {
+        "option": "payments",
+        "equals": true
+      },
+      "then": {
+        "not": {
+          "option": "auth",
+          "equals": "none"
+        }
+      },
+      "message": {
+        "cli": "--payments requires --auth authjs or clerk.",
+        "wizard": "Payments need sign-in, so we can tell who paid."
+      }
+    },
+    {
+      "id": "payments-require-database",
+      "if": {
+        "option": "payments",
+        "equals": true
+      },
+      "then": {
+        "option": "database",
+        "equals": "postgres"
+      },
+      "message": {
+        "cli": "--payments requires --database postgres.",
+        "wizard": "Payments need a database to remember customers and subscriptions."
+      }
+    }
+  ],
+  "aliases": {
+    "@/*": "src/*",
+    "@domain/*": "src/features/*",
+    "@featureUi/*": "src/features/notes/components/*",
+    "@server/*": "src/server/*",
+    "@ui/*": "src/components/ui/*",
+    "@shared/*": "src/shared/*"
+  },
+  "features": [
+    {
+      "id": "package-manager-npm",
+      "description": "Drop pnpm-only files when the package manager is npm.",
+      "when": {
+        "option": "packageManager",
+        "equals": "npm"
+      },
+      "patches": [
+        {
+          "op": "delete",
+          "target": "pnpm-workspace.yaml"
+        }
+      ]
+    },
+    {
+      "id": "orm-drizzle",
+      "description": "Drizzle ORM, drizzle-kit config, TS schema and db helper.",
+      "when": {
+        "all": [
+          {
+            "option": "database",
+            "equals": "postgres"
+          },
+          {
+            "option": "orm",
+            "equals": "drizzle"
+          }
+        ]
+      },
+      "dependencies": {
+        "drizzle-orm": "0.45.4",
+        "postgres": "3.4.9"
+      },
+      "devDependencies": {
+        "drizzle-kit": "0.31.11"
+      },
+      "scripts": {
+        "db:generate": "drizzle-kit generate",
+        "db:migrate": "drizzle-kit migrate",
+        "db:push": "drizzle-kit push --force"
+      },
+      "patches": [
+        {
+          "op": "env",
+          "target": ".env.example",
+          "vars": [
+            {
+              "name": "DATABASE_URL",
+              "example": "postgresql://postgres:postgres@localhost:5432/app",
+              "description": "Postgres connection string"
+            }
+          ]
+        },
+        {
+          "op": "insert",
+          "target": ".github/workflows/ci.yml",
+          "anchor": "ci-job",
+          "source": "features/orm-drizzle/snippets/ci-job.yaml"
+        },
+        {
+          "op": "insert",
+          "target": ".github/workflows/ci.yml",
+          "anchor": "ci-e2e-setup",
+          "source": "features/orm-drizzle/snippets/ci-e2e-setup.yaml"
+        },
+        {
+          "op": "insert",
+          "target": "README.md",
+          "anchor": "readme-sections",
+          "source": "features/orm-drizzle/snippets/readme-db.md"
+        }
+      ],
+      "replaces": [
+        "src/features/notes/notes-store.ts"
+      ]
+    },
+    {
+      "id": "orm-prisma",
+      "description": "Prisma client, schema and db helper.",
+      "when": {
+        "all": [
+          {
+            "option": "database",
+            "equals": "postgres"
+          },
+          {
+            "option": "orm",
+            "equals": "prisma"
+          }
+        ]
+      },
+      "dependencies": {
+        "@prisma/adapter-pg": "7.10.1",
+        "@prisma/client": "7.10.1"
+      },
+      "devDependencies": {
+        "prisma": "7.10.1"
+      },
+      "scripts": {
+        "postinstall": "prisma generate",
+        "db:generate": "prisma generate",
+        "db:migrate": "prisma migrate dev",
+        "db:push": "prisma db push --accept-data-loss"
+      },
+      "patches": [
+        {
+          "op": "env",
+          "target": ".env.example",
+          "vars": [
+            {
+              "name": "DATABASE_URL",
+              "example": "postgresql://postgres:postgres@localhost:5432/app",
+              "description": "Postgres connection string"
+            }
+          ]
+        },
+        {
+          "op": "insert",
+          "target": ".github/workflows/ci.yml",
+          "anchor": "ci-job",
+          "source": "features/orm-prisma/snippets/ci-job.yaml"
+        },
+        {
+          "op": "insert",
+          "target": ".github/workflows/ci.yml",
+          "anchor": "ci-e2e-setup",
+          "source": "features/orm-prisma/snippets/ci-e2e-setup.yaml"
+        },
+        {
+          "op": "insert",
+          "target": "README.md",
+          "anchor": "readme-sections",
+          "source": "features/orm-prisma/snippets/readme-db.md"
+        }
+      ],
+      "replaces": [
+        "src/features/notes/notes-store.ts"
+      ]
+    },
+    {
+      "id": "auth-authjs",
+      "description": "Auth.js with database sessions (adapter added by the ORM combination feature): route handler, session helper, sign-in page, provider wrapper. Only valid with database=postgres.",
+      "when": {
+        "option": "auth",
+        "equals": "authjs"
+      },
+      "after": [
+        "orm-prisma",
+        "orm-drizzle"
+      ],
+      "dependencies": {
+        "next-auth": "4.24.15"
+      },
+      "patches": [
+        {
+          "op": "env",
+          "target": ".env.example",
+          "vars": [
+            {
+              "name": "AUTH_SECRET",
+              "description": "Random secret used to sign sessions"
+            },
+            {
+              "name": "GITHUB_ID",
+              "description": "GitHub OAuth client id"
+            },
+            {
+              "name": "GITHUB_SECRET",
+              "description": "GitHub OAuth client secret"
+            },
+            {
+              "name": "GOOGLE_CLIENT_ID",
+              "description": "Google OAuth client id"
+            },
+            {
+              "name": "GOOGLE_CLIENT_SECRET",
+              "description": "Google OAuth client secret"
+            }
+          ]
+        },
+        {
+          "op": "insert",
+          "target": "src/app/providers.tsx",
+          "anchor": "providers-imports",
+          "source": "features/auth-authjs/snippets/providers-imports.tsx"
+        },
+        {
+          "op": "insert",
+          "target": "src/app/providers.tsx",
+          "anchor": "providers",
+          "source": "features/auth-authjs/snippets/providers.tsx"
+        }
+      ]
+    },
+    {
+      "id": "auth-authjs-prisma",
+      "description": "Combination overlay: Auth.js adapter and auth models for Prisma.",
+      "when": {
+        "all": [
+          {
+            "option": "auth",
+            "equals": "authjs"
+          },
+          {
+            "all": [
+              {
+                "option": "database",
+                "equals": "postgres"
+              },
+              {
+                "option": "orm",
+                "equals": "prisma"
+              }
+            ]
+          }
+        ]
+      },
+      "after": [
+        "auth-authjs"
+      ],
+      "dependencies": {
+        "@auth/prisma-adapter": "2.11.3"
+      },
+      "patches": [
+        {
+          "op": "insert",
+          "target": "prisma/schema.prisma",
+          "anchor": "models",
+          "source": "features/auth-authjs-prisma/snippets/auth-models.prisma"
+        },
+        {
+          "op": "insert",
+          "target": "src/server/auth/config.ts",
+          "anchor": "adapter-imports",
+          "source": "features/auth-authjs-prisma/snippets/adapter-imports.ts"
+        },
+        {
+          "op": "insert",
+          "target": "src/server/auth/config.ts",
+          "anchor": "adapter-db-imports",
+          "source": "features/auth-authjs-prisma/snippets/adapter-db-imports.ts"
+        },
+        {
+          "op": "insert",
+          "target": "src/server/auth/config.ts",
+          "anchor": "adapter",
+          "source": "features/auth-authjs-prisma/snippets/adapter.ts"
+        }
+      ]
+    },
+    {
+      "id": "auth-authjs-drizzle",
+      "description": "Combination overlay: Auth.js adapter and auth tables for Drizzle.",
+      "when": {
+        "all": [
+          {
+            "option": "auth",
+            "equals": "authjs"
+          },
+          {
+            "all": [
+              {
+                "option": "database",
+                "equals": "postgres"
+              },
+              {
+                "option": "orm",
+                "equals": "drizzle"
+              }
+            ]
+          }
+        ]
+      },
+      "after": [
+        "auth-authjs"
+      ],
+      "dependencies": {
+        "@auth/drizzle-adapter": "1.11.3"
+      },
+      "patches": [
+        {
+          "op": "insert",
+          "target": "src/server/db/schema.ts",
+          "anchor": "tables",
+          "source": "features/auth-authjs-drizzle/snippets/auth-tables.ts"
+        },
+        {
+          "op": "insert",
+          "target": "src/server/auth/config.ts",
+          "anchor": "adapter-imports",
+          "source": "features/auth-authjs-drizzle/snippets/adapter-imports.ts"
+        },
+        {
+          "op": "insert",
+          "target": "src/server/auth/config.ts",
+          "anchor": "adapter-db-imports",
+          "source": "features/auth-authjs-drizzle/snippets/adapter-db-imports.ts"
+        },
+        {
+          "op": "insert",
+          "target": "src/server/auth/config.ts",
+          "anchor": "adapter",
+          "source": "features/auth-authjs-drizzle/snippets/adapter.ts"
+        }
+      ]
+    },
+    {
+      "id": "auth-clerk",
+      "description": "Clerk provider, middleware and sign-in/up routes. Works with or without a database.",
+      "when": {
+        "option": "auth",
+        "equals": "clerk"
+      },
+      "dependencies": {
+        "@clerk/nextjs": "7.9.17"
+      },
+      "patches": [
+        {
+          "op": "env",
+          "target": ".env.example",
+          "vars": [
+            {
+              "name": "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY",
+              "description": "Clerk publishable key",
+              "public": true
+            },
+            {
+              "name": "CLERK_SECRET_KEY",
+              "description": "Clerk secret key"
+            }
+          ]
+        },
+        {
+          "op": "insert",
+          "target": "src/app/providers.tsx",
+          "anchor": "providers-imports",
+          "source": "features/auth-clerk/snippets/providers-imports.tsx"
+        },
+        {
+          "op": "insert",
+          "target": "src/app/providers.tsx",
+          "anchor": "providers",
+          "source": "features/auth-clerk/snippets/providers.tsx"
+        }
+      ]
+    },
+    {
+      "id": "api-server-actions",
+      "description": "Example server action, validation helper and test.",
+      "when": {
+        "option": "api",
+        "equals": "server-actions"
+      }
+    },
+    {
+      "id": "api-trpc",
+      "description": "tRPC router, context, Next.js route handler and React client provider.",
+      "when": {
+        "option": "api",
+        "equals": "trpc"
+      },
+      "after": [
+        "auth-authjs",
+        "auth-clerk"
+      ],
+      "dependencies": {
+        "@trpc/server": "11.19.0",
+        "@trpc/client": "11.19.0",
+        "@trpc/react-query": "11.19.0",
+        "@tanstack/react-query": "5.104.4"
+      },
+      "replaces": [
+        "src/features/notes/components/note-form.tsx"
+      ],
+      "patches": [
+        {
+          "op": "insert",
+          "target": "src/app/providers.tsx",
+          "anchor": "providers-imports",
+          "source": "features/api-trpc/snippets/providers-imports.tsx"
+        },
+        {
+          "op": "insert",
+          "target": "src/app/providers.tsx",
+          "anchor": "providers",
+          "source": "features/api-trpc/snippets/providers.tsx",
+          "position": "after"
+        }
+      ]
+    },
+    {
+      "id": "payments-stripe",
+      "description": "Stripe checkout route, webhook handler and billing helper. Requires auth and Postgres.",
+      "when": {
+        "option": "payments",
+        "equals": true
+      },
+      "after": [
+        "auth-authjs",
+        "auth-clerk",
+        "orm-prisma",
+        "orm-drizzle"
+      ],
+      "dependencies": {
+        "stripe": "23.0.0"
+      },
+      "patches": [
+        {
+          "op": "env",
+          "target": ".env.example",
+          "vars": [
+            {
+              "name": "STRIPE_SECRET_KEY",
+              "description": "Stripe secret key"
+            },
+            {
+              "name": "STRIPE_WEBHOOK_SECRET",
+              "description": "Signing secret for the Stripe webhook endpoint"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "payments-stripe-prisma",
+      "description": "Combination overlay: customer/subscription models for Prisma.",
+      "when": {
+        "all": [
+          {
+            "option": "payments",
+            "equals": true
+          },
+          {
+            "all": [
+              {
+                "option": "database",
+                "equals": "postgres"
+              },
+              {
+                "option": "orm",
+                "equals": "prisma"
+              }
+            ]
+          }
+        ]
+      },
+      "after": [
+        "payments-stripe",
+        "auth-authjs-prisma"
+      ],
+      "patches": [
+        {
+          "op": "insert",
+          "target": "prisma/schema.prisma",
+          "anchor": "models",
+          "source": "features/payments-stripe-prisma/snippets/billing-models.prisma",
+          "position": "after"
+        }
+      ]
+    },
+    {
+      "id": "payments-stripe-drizzle",
+      "description": "Combination overlay: customer/subscription tables for Drizzle.",
+      "when": {
+        "all": [
+          {
+            "option": "payments",
+            "equals": true
+          },
+          {
+            "all": [
+              {
+                "option": "database",
+                "equals": "postgres"
+              },
+              {
+                "option": "orm",
+                "equals": "drizzle"
+              }
+            ]
+          }
+        ]
+      },
+      "after": [
+        "payments-stripe",
+        "auth-authjs-drizzle"
+      ],
+      "patches": [
+        {
+          "op": "insert",
+          "target": "src/server/db/schema.ts",
+          "anchor": "tables",
+          "source": "features/payments-stripe-drizzle/snippets/billing-tables.ts",
+          "position": "after"
+        }
+      ]
+    },
+    {
+      "id": "deploy-vercel",
+      "description": "Vercel deploy notes and README section.",
+      "when": {
+        "option": "deploy",
+        "equals": "vercel"
+      },
+      "patches": [
+        {
+          "op": "insert",
+          "target": "README.md",
+          "anchor": "readme-sections",
+          "source": "features/deploy-vercel/snippets/readme-deploy.md",
+          "position": "before"
+        }
+      ],
+      "after": [
+        "orm-drizzle"
+      ]
+    },
+    {
+      "id": "deploy-docker",
+      "description": "Dockerfile, .dockerignore, compose file for the app, standalone output.",
+      "when": {
+        "option": "deploy",
+        "equals": "docker"
+      },
+      "scripts": {
+        "image:build": "docker build -t yosr-seed-prototype:gate ."
+      },
+      "patches": [
+        {
+          "op": "insert",
+          "target": "next.config.ts",
+          "anchor": "next-config",
+          "content": "...(process.env.YOSR_STANDALONE === \"1\" ? { output: \"standalone\" as const } : {}),"
+        }
+      ]
+    },
+    {
+      "id": "deploy-docker-npm",
+      "description": "Docker install stage for npm: copy package-lock.json and run npm ci.",
+      "when": {
+        "all": [
+          {
+            "option": "deploy",
+            "equals": "docker"
+          },
+          {
+            "option": "packageManager",
+            "equals": "npm"
+          }
+        ]
+      },
+      "after": [
+        "deploy-docker"
+      ],
+      "replaces": [
+        "Dockerfile"
+      ]
+    },
+    {
+      "id": "deploy-docker-postgres",
+      "description": "Combination overlay: adds a Postgres service to the compose file.",
+      "when": {
+        "all": [
+          {
+            "option": "deploy",
+            "equals": "docker"
+          },
+          {
+            "option": "database",
+            "equals": "postgres"
+          }
+        ]
+      },
+      "after": [
+        "deploy-docker"
+      ],
+      "patches": [
+        {
+          "op": "insert",
+          "target": "compose.yaml",
+          "anchor": "services",
+          "source": "features/deploy-docker-postgres/snippets/postgres-service.yaml"
+        }
+      ]
+    }
+  ],
+  "style": {
+    "dimensions": [
+      {
+        "id": "layout",
+        "description": "Feature-based (by domain), layer-based (by technical type) or flat folders. Matches style-profile 'layout'.",
+        "default": "feature",
+        "values": {
+          "feature": {
+            "pathMap": {
+              "@domain": "src/features",
+              "@shared": "src/shared",
+              "@server": "src/server",
+              "@featureUi": "src/features/notes/components"
+            },
+            "rules": [
+              "layout-feature"
+            ]
+          },
+          "layer": {
+            "pathMap": {
+              "@domain": "src/services",
+              "@shared": "src/lib",
+              "@server": "src/server",
+              "@featureUi": "src/components/notes"
+            },
+            "rules": [
+              "layout-layer"
+            ]
+          },
+          "flat": {
+            "pathMap": {
+              "@domain": "src/lib",
+              "@shared": "src/lib/shared",
+              "@server": "src/lib/server",
+              "@featureUi": "src/components/notes"
+            },
+            "rules": [
+              "layout-flat"
+            ]
+          }
+        }
+      },
+      {
+        "id": "naming.files",
+        "description": "File naming convention for source files.",
+        "default": "kebab-case",
+        "values": {
+          "kebab-case": {},
+          "camelCase": {
+            "patches": [
+              {
+                "op": "codemod",
+                "codemod": "builtin:rename-files",
+                "args": {
+                  "case": "camel",
+                  "include": [
+                    "src/**/*.ts",
+                    "src/**/*.tsx"
+                  ],
+                  "exclude": [
+                    "src/app/**",
+                    "src/components/ui/**"
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      },
+      {
+        "id": "naming.componentFiles",
+        "description": "React component file names: same casing as other files, or PascalCase.",
+        "default": "same-as-files",
+        "values": {
+          "same-as-files": {},
+          "PascalCase": {
+            "patches": [
+              {
+                "op": "codemod",
+                "codemod": "builtin:rename-files",
+                "args": {
+                  "case": "pascal",
+                  "include": [
+                    "src/components/**/*.tsx",
+                    "@domain/**/components/**/*.tsx"
+                  ],
+                  "exclude": [
+                    "src/components/ui/**"
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      },
+      {
+        "id": "errors.pattern",
+        "description": "How expected failures are returned from server code.",
+        "default": "throw",
+        "values": {
+          "throw": {
+            "rules": [
+              "errors-throw"
+            ]
+          },
+          "result": {
+            "variantDir": "style/errors-result",
+            "rules": [
+              "errors-result"
+            ]
+          }
+        }
+      },
+      {
+        "id": "data.fetching",
+        "description": "Only server-first is supported by this template in v0.1.",
+        "default": "server-first",
+        "values": {
+          "server-first": {
+            "rules": [
+              "data-server-first"
+            ]
+          }
+        }
+      },
+      {
+        "id": "forms.validation",
+        "description": "Only zod is supported by this template in v0.1.",
+        "default": "zod",
+        "values": {
+          "zod": {
+            "rules": [
+              "forms-zod"
+            ]
+          }
+        }
+      },
+      {
+        "id": "tests.location",
+        "description": "Unit tests next to the code, in adjacent __tests__/ folders, or in a top-level tests/ tree.",
+        "default": "colocated",
+        "values": {
+          "colocated": {
+            "rules": [
+              "tests-colocated"
+            ]
+          },
+          "tests-folder": {
+            "patches": [
+              {
+                "op": "codemod",
+                "codemod": "builtin:move-tests",
+                "args": {
+                  "mode": "adjacent-dir",
+                  "dir": "__tests__"
+                }
+              }
+            ],
+            "rules": [
+              "tests-folder"
+            ]
+          },
+          "separate": {
+            "patches": [
+              {
+                "op": "codemod",
+                "codemod": "builtin:move-tests",
+                "args": {
+                  "to": "tests/unit"
+                }
+              },
+              {
+                "op": "json-merge",
+                "target": "tsconfig.json",
+                "arrays": "append",
+                "value": {
+                  "include": [
+                    "tests/**/*.ts"
+                  ]
+                }
+              }
+            ],
+            "rules": [
+              "tests-separate"
+            ]
+          }
+        }
+      },
+      {
+        "id": "tests.naming",
+        "description": "Unit-test file suffix. .test leaves shipped unit tests unchanged. .spec renames .test. to .spec. under src/ and tests/ only.",
+        "default": ".test",
+        "values": {
+          ".test": {},
+          ".spec": {
+            "patches": [
+              {
+                "op": "codemod",
+                "codemod": "builtin:rename-test-suffix",
+                "args": {
+                  "from": ".test.",
+                  "to": ".spec."
+                }
+              }
+            ]
+          }
+        }
+      }
+    ]
+  },
+  "enforcement": {
+    "eslint": {
+      "target": "eslint.config.mjs",
+      "anchor": "eslint-style"
+    },
+    "prettier": {
+      "target": ".prettierrc.json"
+    },
+    "tsconfig": {
+      "target": "tsconfig.json"
+    }
+  },
+  "zones": [
+    {
+      "id": "domain-features",
+      "intent": "Domain logic for the user's app: one folder per feature with its server functions, validation schemas and unit tests. Follow the existing example feature. Use the db helper in src/server/db only when a database is configured.",
+      "paths": {
+        "create": [
+          "@domain/**",
+          "@featureUi/**"
+        ],
+        "modify": [
+          "@domain/**",
+          "@featureUi/**"
+        ]
+      },
+      "context": [
+        "@domain/example/**",
+        "AGENTS.md"
+      ],
+      "constraints": {
+        "maxFiles": 40,
+        "allowDependencies": [
+          "zod"
+        ],
+        "forbidPatterns": [
+          "process\\.env\\.[A-Z_]+_SECRET"
+        ]
+      },
+      "tests": {
+        "required": true,
+        "paths": [
+          "@domain/**/*.test.ts"
+        ]
+      }
+    },
+    {
+      "id": "app-pages",
+      "intent": "Pages and layouts for the user's app inside the authenticated app area, composed from shadcn/ui components.",
+      "paths": {
+        "create": [
+          "src/app/(app)/**"
+        ],
+        "modify": [
+          "src/app/(app)/**"
+        ]
+      },
+      "context": [
+        "src/components/ui/**",
+        "src/app/layout.tsx"
+      ],
+      "constraints": {
+        "maxFiles": 30
+      },
+      "tests": {
+        "required": false
+      }
+    },
+    {
+      "id": "db-schema-prisma",
+      "intent": "Add the app's data models to the Prisma schema below the models anchor. Do not change auth models.",
+      "when": {
+        "all": [
+          {
+            "option": "database",
+            "equals": "postgres"
+          },
+          {
+            "option": "orm",
+            "equals": "prisma"
+          }
+        ]
+      },
+      "paths": {
+        "modify": [
+          "prisma/schema.prisma"
+        ]
+      },
+      "constraints": {
+        "maxChangedLines": 200
+      },
+      "tests": {
+        "required": false
+      }
+    },
+    {
+      "id": "db-schema-drizzle",
+      "intent": "Add the app's tables to the Drizzle schema. Do not change auth tables.",
+      "when": {
+        "all": [
+          {
+            "option": "database",
+            "equals": "postgres"
+          },
+          {
+            "option": "orm",
+            "equals": "drizzle"
+          }
+        ]
+      },
+      "paths": {
+        "modify": [
+          "src/server/db/schema.ts"
+        ]
+      },
+      "constraints": {
+        "maxChangedLines": 200
+      },
+      "tests": {
+        "required": false
+      }
+    }
+  ],
+  "protected": [
+    "src/server/auth/**",
+    "src/middleware.ts",
+    "src/proxy.ts",
+    "src/app/api/webhooks/**",
+    ".github/**"
+  ],
+  "rules": {
+    "targets": [
+      "agents-md",
+      "claude-md",
+      "cursor-rules"
+    ],
+    "fragments": [
+      {
+        "id": "project-overview",
+        "file": "rules/project-overview.md",
+        "title": "Project overview",
+        "order": 10,
+        "cursor": {
+          "alwaysApply": true,
+          "description": "What this project is and how it is laid out"
+        }
+      },
+      {
+        "id": "commands",
+        "file": "rules/commands.md",
+        "title": "Commands",
+        "order": 20,
+        "cursor": {
+          "alwaysApply": true
+        }
+      },
+      {
+        "id": "layout-feature",
+        "file": "rules/layout-feature.md",
+        "title": "Folder layout",
+        "order": 30,
+        "cursor": {
+          "globs": [
+            "src/**"
+          ]
+        }
+      },
+      {
+        "id": "layout-layer",
+        "file": "rules/layout-layer.md",
+        "title": "Folder layout",
+        "order": 30,
+        "cursor": {
+          "globs": [
+            "src/**"
+          ]
+        }
+      },
+      {
+        "id": "layout-flat",
+        "file": "rules/layout-flat.md",
+        "title": "Folder layout",
+        "order": 30,
+        "cursor": {
+          "globs": [
+            "src/**"
+          ]
+        }
+      },
+      {
+        "id": "errors-throw",
+        "file": "rules/errors-throw.md",
+        "title": "Error handling",
+        "order": 40,
+        "cursor": {
+          "globs": [
+            "src/server/**",
+            "@domain/**"
+          ]
+        }
+      },
+      {
+        "id": "errors-result",
+        "file": "rules/errors-result.md",
+        "title": "Error handling",
+        "order": 40,
+        "cursor": {
+          "globs": [
+            "src/server/**",
+            "@domain/**"
+          ]
+        }
+      },
+      {
+        "id": "data-server-first",
+        "file": "rules/data-server-first.md",
+        "title": "Data fetching",
+        "order": 45
+      },
+      {
+        "id": "forms-zod",
+        "file": "rules/forms-zod.md",
+        "title": "Forms and validation",
+        "order": 46
+      },
+      {
+        "id": "tests-colocated",
+        "file": "rules/tests-colocated.md",
+        "title": "Testing",
+        "order": 50,
+        "cursor": {
+          "globs": [
+            "**/*.test.ts",
+            "**/*.test.tsx",
+            "**/*.spec.ts",
+            "**/*.spec.tsx"
+          ]
+        }
+      },
+      {
+        "id": "tests-folder",
+        "file": "rules/tests-folder.md",
+        "title": "Testing",
+        "order": 50,
+        "cursor": {
+          "globs": [
+            "**/__tests__/**"
+          ]
+        }
+      },
+      {
+        "id": "tests-separate",
+        "file": "rules/tests-separate.md",
+        "title": "Testing",
+        "order": 50,
+        "cursor": {
+          "globs": [
+            "tests/**"
+          ]
+        }
+      },
+      {
+        "id": "auth-authjs",
+        "file": "rules/auth-authjs.md",
+        "title": "Authentication (Auth.js)",
+        "order": 60,
+        "when": {
+          "option": "auth",
+          "equals": "authjs"
+        }
+      },
+      {
+        "id": "auth-clerk",
+        "file": "rules/auth-clerk.md",
+        "title": "Authentication (Clerk)",
+        "order": 60,
+        "when": {
+          "option": "auth",
+          "equals": "clerk"
+        }
+      },
+      {
+        "id": "data-prisma",
+        "file": "rules/data-prisma.md",
+        "title": "Data access (Prisma)",
+        "order": 70,
+        "when": {
+          "all": [
+            {
+              "option": "database",
+              "equals": "postgres"
+            },
+            {
+              "option": "orm",
+              "equals": "prisma"
+            }
+          ]
+        },
+        "cursor": {
+          "globs": [
+            "prisma/**",
+            "src/server/db/**"
+          ]
+        }
+      },
+      {
+        "id": "data-drizzle",
+        "file": "rules/data-drizzle.md",
+        "title": "Data access (Drizzle)",
+        "order": 70,
+        "when": {
+          "all": [
+            {
+              "option": "database",
+              "equals": "postgres"
+            },
+            {
+              "option": "orm",
+              "equals": "drizzle"
+            }
+          ]
+        },
+        "cursor": {
+          "globs": [
+            "src/server/db/**"
+          ]
+        }
+      },
+      {
+        "id": "data-none",
+        "file": "rules/data-none.md",
+        "title": "Data (no database)",
+        "order": 70,
+        "when": {
+          "option": "database",
+          "equals": "none"
+        }
+      },
+      {
+        "id": "api-server-actions",
+        "file": "rules/api-server-actions.md",
+        "title": "API (server actions)",
+        "order": 80,
+        "when": {
+          "option": "api",
+          "equals": "server-actions"
+        }
+      },
+      {
+        "id": "api-trpc",
+        "file": "rules/api-trpc.md",
+        "title": "API (tRPC)",
+        "order": 80,
+        "when": {
+          "option": "api",
+          "equals": "trpc"
+        },
+        "cursor": {
+          "globs": [
+            "src/server/api/**"
+          ]
+        }
+      },
+      {
+        "id": "payments-stripe",
+        "file": "rules/payments-stripe.md",
+        "title": "Payments (Stripe)",
+        "order": 90,
+        "when": {
+          "option": "payments",
+          "equals": true
+        }
+      },
+      {
+        "id": "ui-shadcn",
+        "file": "rules/ui-shadcn.md",
+        "title": "UI components",
+        "order": 100,
+        "cursor": {
+          "globs": [
+            "src/components/**",
+            "src/app/**/*.tsx"
+          ]
+        }
+      }
+    ],
+    "architectureNote": {
+      "source": "rules/architecture.md",
+      "target": "docs/architecture.md"
+    }
+  },
+  "checks": {
+    "maxFixAttempts": 3,
+    "services": [
+      {
+        "id": "postgres",
+        "image": "postgres:18.6-alpine",
+        "env": {
+          "POSTGRES_PASSWORD": "postgres"
+        },
+        "when": {
+          "option": "database",
+          "equals": "postgres"
+        }
+      }
+    ],
+    "steps": [
+      {
+        "id": "install",
+        "kind": "install",
+        "run": {
+          "install": true
+        },
+        "timeoutSec": 600
+      },
+      {
+        "id": "lint",
+        "kind": "lint",
+        "run": {
+          "script": "lint"
+        },
+        "timeoutSec": 300
+      },
+      {
+        "id": "typecheck",
+        "kind": "typecheck",
+        "run": {
+          "script": "typecheck"
+        },
+        "timeoutSec": 300
+      },
+      {
+        "id": "build",
+        "kind": "build",
+        "run": {
+          "script": "build"
+        },
+        "timeoutSec": 900,
+        "env": {
+          "SKIP_ENV_VALIDATION": "1"
+        }
+      },
+      {
+        "id": "test",
+        "kind": "test",
+        "run": {
+          "script": "test"
+        },
+        "timeoutSec": 600
+      },
+      {
+        "id": "image",
+        "kind": "custom",
+        "run": {
+          "script": "image:build"
+        },
+        "timeoutSec": 900,
+        "required": false,
+        "when": {
+          "option": "deploy",
+          "equals": "docker"
+        },
+        "phases": [
+          "handoff",
+          "template-ci",
+          "project-ci"
+        ]
+      },
+      {
+        "id": "db-setup",
+        "kind": "custom",
+        "run": {
+          "script": "db:push"
+        },
+        "timeoutSec": 120,
+        "required": false,
+        "when": {
+          "option": "database",
+          "equals": "postgres"
+        },
+        "phases": [
+          "handoff",
+          "template-ci",
+          "project-ci"
+        ]
+      },
+      {
+        "id": "e2e",
+        "kind": "e2e",
+        "run": {
+          "script": "test:e2e"
+        },
+        "timeoutSec": 900,
+        "required": false,
+        "phases": [
+          "handoff",
+          "template-ci",
+          "project-ci"
+        ]
+      }
+    ],
+    "report": {
+      "path": ".seed/report.md"
+    }
+  },
+  "matrix": {
+    "strategy": "pairwise",
+    "packageManagers": [
+      "pnpm",
+      "npm"
+    ],
+    "styleDimensions": [
+      "layout",
+      "errors.pattern",
+      "tests.location"
+    ],
+    "include": [
+      {
+        "name": "defaults",
+        "options": {}
+      },
+      {
+        "name": "defaults-npm",
+        "options": {},
+        "packageManager": "npm"
+      },
+      {
+        "name": "minimal",
+        "options": {
+          "database": "none",
+          "auth": "none",
+          "api": "server-actions",
+          "deploy": "vercel"
+        }
+      },
+      {
+        "name": "no-db-clerk",
+        "options": {
+          "database": "none",
+          "auth": "clerk",
+          "api": "trpc",
+          "deploy": "docker"
+        }
+      },
+      {
+        "name": "kitchen-sink",
+        "options": {
+          "database": "postgres",
+          "orm": "prisma",
+          "auth": "authjs",
+          "api": "trpc",
+          "payments": true,
+          "deploy": "docker"
+        },
+        "style": {
+          "layout": "layer",
+          "naming.files": "camelCase",
+          "naming.componentFiles": "PascalCase",
+          "errors.pattern": "result",
+          "tests.location": "tests-folder"
+        }
+      },
+      {
+        "name": "minimal-preset",
+        "options": {
+          "database": "none"
+        },
+        "style": {
+          "layout": "flat"
+        }
+      }
+    ]
+  },
+  "migrations": [],
+  "x-prototype": {
+    "status": "prototype, not published",
+    "stubbedFeatures": [],
+    "notes": "No features are stubbed. The prototype renderer still refuses any id listed in stubbedFeatures."
+  }
+}