@yosr-ai/template-next-fullstack 0.1.0-alpha.5 → 0.1.0-alpha.7

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @yosr-ai/template-next-fullstack
 
+## 0.1.0-alpha.7
+
+### Minor Changes
+
+- 8d7a4e5: Add the FastAPI template (`--template fastapi`, ADRs 0017 and 0018): uv, Python 3.12+, Pydantic v2, Ruff, Pyright, pytest, a notes API, database none/SQLite/Postgres, API-key auth, Docker. `--template` selection (TTY asks Template first; otherwise `next-fullstack` with a `Using template:` line), `yosr-seed gate`, and Python/uv info lines in `doctor`.
+- f3b8706: Named style profiles (ADR 0015): `profiles/<name>.json` + `config.json`, migrate from `profile.json`, create `--profile <name>`, and record `profileName` / `profileHash` in `.seed/`.
+- edded9a: Add create-time `--workflow` (Local / GitHub / None) with engine-level tracker files, agent pointer files, and AGENTS.md loop docs (ADR 0016).
+
+### Patch Changes
+
+- 2309eb3: CLI dogfood fixes: forward TTY for `profile create`, default editor when VISUAL/EDITOR unset, and saved-style labels from applied style.
+- c43a813: Drop stale legal-review wording now that the Yosr Seed License text is accepted, trim the invalid `@alpha@<version>` note from the CLI READMEs, and add a docker-prisma golden for the Prisma Docker pre-install COPY and compose wiring.
+- 394a9fb: Template dogfood: Docker README for database=none, project-name image tag, seed.yosr.ai link, and app-pages zones under src/app/** (no (app) group).
+
+## 0.1.0-alpha.6
+
+### Patch Changes
+
+- 9a2dfd0: Postgres + Docker Compose publishes 5432, waits on `pg_isready`, sets app `DATABASE_URL` to the `postgres` service, and documents a host `db:push` schema step before `docker compose up --build`. Prisma images copy the schema before install so `prisma generate` works.
+- 7b41bfb: Yosr Seed CLI packages use the Yosr Seed License from 0.1.0; the template stays MIT; generated projects belong to you. Alphas through 0.1.0-alpha.5 remain MIT.
+- 700d8bd: npm-facing READMEs for users without the private repo, homepage and bugs email on the packages, and a contact address on the Yosr Seed License.
+
 ## 0.1.0-alpha.5
 
 ### Patch Changes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wael Zohny / Yosr AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,16 +1,11 @@
 # `@yosr-ai/template-next-fullstack`
 
-The Yosr Seed next-fullstack template. License: MIT. Node.js: `>=24`. CLI usage is in the [repository README](https://github.com/getyosr/yosr-seed#readme).
+The **Yosr Seed** next-fullstack template. License: **MIT**. Node.js `>=24`.
 
-For template authors; not rendered. Layout follows the template format spec.
+You normally get this package through [`create-yosr-seed`](https://www.npmjs.com/package/create-yosr-seed) / [`yosr-seed`](https://www.npmjs.com/package/yosr-seed); you do not need to install it by hand to create a project.
 
-- `seed.template.json`: manifest. Started from `examples/next-fullstack/seed.template.json`; dependency versions pinned from the npm registry on 2026-10-19. `x-prototype.stubbedFeatures` is empty. The selftest stub is fixture-only.
-- `files/`: the base. It is a real Next.js app that installs, lints, type-checks, builds and tests on its own (checked). Files sit at the **default** layout's concrete paths (`src/features`, `src/shared`, `src/server`); the renderer relocates them for other layouts. `gitignore` is renamed to `.gitignore` on render (npm strips `.gitignore` from published packages).
-- `features/orm-drizzle/`: Postgres + Drizzle overlay (replaces the in-memory notes store). `database: none` is the base without this overlay.
-- `features/orm-prisma/`: Postgres + Prisma overlay (same role as Drizzle: schema, client, notes store via `replaces`). `prisma generate` runs on install. The generated client is not committed.
-- `features/deploy-vercel/`: README section only.
-- `features/deploy-docker/`: Dockerfile, `.dockerignore`, and `compose.yaml` for `deploy: docker`. The `next-config` anchor turns on `output: "standalone"` only when `YOSR_STANDALONE=1`, which the Dockerfile sets for the image build. Local `next start` does not use standalone output. `features/deploy-docker-postgres/` adds a Postgres service to that compose file when `database` is `postgres`. The image build is a non-required gate step (`--image`).
-- `style/errors-result/`: variant tree for `errors.pattern = result`.
-- `rules/`: agent-rule fragments and the architecture note source.
+## Bugs and feedback
 
-Anchors (`@seed:anchor <name>`) must be alone on their line; inserted content takes the anchor line's indentation; anchors are removed from output.
+Email **wzohny@gmail.com**. The source repository is private, so there is no public issue tracker.
+
+Site: [seed.yosr.ai](https://seed.yosr.ai)

package/features/deploy-docker/files/Dockerfile

@@ -6,6 +6,7 @@ ENV NEXT_TELEMETRY_DISABLED=1
 ENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0
 
 COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+# @seed:anchor docker-pre-install
 RUN corepack enable && __seed_pmInstallCi__
 COPY . .
 # Standalone output is for this image only. Local `next start` leaves this unset.

package/features/deploy-docker/files/compose.yaml

@@ -1,6 +1,9 @@
+# @seed:anchor compose-header
 services:
   app:
     build: .
     ports:
       - "3000:3000"
+    # @seed:anchor app-config
   # @seed:anchor services
+# @seed:anchor compose-root

package/features/deploy-docker/snippets/readme-docker.md

@@ -0,0 +1,17 @@
+## Docker
+
+Build and run the app with Compose:
+
+```text
+docker compose up --build
+```
+
+Or build the image alone:
+
+```text
+__seed_pmRun__ image:build
+```
+
+That tags `__seed_projectSlug__:latest`. Then open http://localhost:3000.
+
+The Dockerfile sets `YOSR_STANDALONE=1` so Next.js emits a standalone server. The image does not read `.env.local` (see `.dockerignore`).

package/features/deploy-docker-npm/files/Dockerfile

@@ -6,6 +6,7 @@ ENV NEXT_TELEMETRY_DISABLED=1
 ENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0
 
 COPY package.json package-lock.json ./
+# @seed:anchor docker-pre-install
 RUN npm ci
 COPY . .
 # Standalone output is for this image only. Local `next start` leaves this unset.

package/features/deploy-docker-postgres/snippets/app-config.yaml

@@ -0,0 +1,6 @@
+environment:
+  # Local-dev default. Hostname is the compose service name `postgres`, not localhost.
+  DATABASE_URL: postgres://postgres:postgres@postgres:5432/postgres
+depends_on:
+  postgres:
+    condition: service_healthy

package/features/deploy-docker-postgres/snippets/compose-header.yaml

@@ -0,0 +1,2 @@
+# Local Docker Compose with Postgres. See README → Docker for the schema step.
+# The Postgres password below is a local-dev default only — change it for anything beyond local use.

package/features/deploy-docker-postgres/snippets/compose-volumes.yaml

@@ -0,0 +1,2 @@
+volumes:
+  postgres_data:

package/features/deploy-docker-postgres/snippets/postgres-service.yaml

@@ -1,4 +1,16 @@
 postgres:
   image: postgres:18.6-alpine
   environment:
+    # Local-dev default password only — change for anything beyond local use.
     POSTGRES_PASSWORD: postgres
+  # Change the left side if a local Postgres already uses 5432.
+  ports:
+    - "5432:5432"
+  volumes:
+    # Postgres 18+ stores data under a versioned subdir of /var/lib/postgresql.
+    - postgres_data:/var/lib/postgresql
+  healthcheck:
+    test: ["CMD-SHELL", "pg_isready -U postgres"]
+    interval: 5s
+    timeout: 5s
+    retries: 5

package/features/deploy-docker-postgres/snippets/readme-docker.md

@@ -0,0 +1,18 @@
+## Postgres with Docker
+
+Postgres is wired in `compose.yaml` (`DATABASE_URL` uses the `postgres` service hostname). Local-dev password is `postgres` — change it for anything beyond local use.
+
+1. Start Postgres and create tables (from the project root, with Node deps installed):
+
+```text
+docker compose up -d postgres
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/postgres __seed_pmRun__ db:push
+```
+
+2. Build and run the app (see the Docker section above for Compose / `image:build`):
+
+```text
+docker compose up --build
+```
+
+For a bare `docker run` of the image, pass `-e DATABASE_URL=...` yourself. The image does not read `.env.local` (see `.dockerignore`).

package/features/deploy-docker-prisma/snippets/docker-pre-install.Dockerfile

@@ -0,0 +1,3 @@
+# Prisma postinstall needs the schema before `pnpm install` / `npm ci`.
+COPY prisma ./prisma
+COPY prisma.config.ts ./

package/files/README.md

@@ -1,6 +1,6 @@
 # __seed_projectName__
 
-Generated by [Yosr Seed](https://yosr.ai) from the `__seed_templateName__@__seed_templateVersion__` template.
+Generated by [Yosr Seed](https://seed.yosr.ai) from the `__seed_templateName__@__seed_templateVersion__` template.
 
 ## Commands
 
@@ -13,6 +13,6 @@ Generated by [Yosr Seed](https://yosr.ai) from the `__seed_templateName__@__seed
 | E2E smoke test (Playwright) | `__seed_pmRun__ test:e2e` |
 | Format | `__seed_pmRun__ format` |
 
-Agent rules live in `AGENTS.md` (also read by Claude Code via `CLAUDE.md` and by Cursor via `.cursor/rules/`). The architecture note is in `docs/architecture.md`.
+Agent rules live in `AGENTS.md` (Claude Code via `CLAUDE.md`, Cursor via `.cursor/rules/`, GitHub Copilot via `.github/copilot-instructions.md`, Gemini via `GEMINI.md`). The architecture note is in `docs/architecture.md`.
 
 <!-- @seed:anchor readme-sections -->

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@yosr-ai/template-next-fullstack",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.7",
   "description": "Yosr Seed next-fullstack template.",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/getyosr/yosr-seed.git",
-    "directory": "packages/template-next-fullstack"
+  "homepage": "https://seed.yosr.ai",
+  "bugs": {
+    "email": "wzohny@gmail.com"
   },
   "type": "module",
   "exports": {
@@ -16,6 +15,7 @@
   "files": [
     "README.md",
     "CHANGELOG.md",
+    "LICENSE",
     "seed.template.json",
     "files",
     "features",

package/rules/architecture.md

@@ -8,4 +8,4 @@ Next.js (App Router) + TypeScript, Tailwind CSS v4 + shadcn/ui, Vitest (unit) +
 
 ## Request flow
 
-`src/app/page.tsx` (Server Component) reads notes through the feature store, renders `NoteForm` (client) and `NoteList` (server). The form posts to a server action, which validates with zod, stores the note and revalidates the page.
+`src/app/page.tsx` (Server Component) reads notes through the feature store, renders `NoteForm` (client) and `NoteList` (server). The form posts to a server action, which validates with zod, stores the note and revalidates the page. App routes live under `src/app/` (no `(app)` route group); API handlers under `src/app/api/` and auth sign-in/sign-up pages stay with their features.

package/seed.template.json

@@ -2,7 +2,7 @@
   "$schema": "../../../docs/engineering/schemas/seed.template.schema.json",
   "schemaVersion": "0.1",
   "name": "next-fullstack",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.7",
   "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",
@@ -261,6 +261,42 @@
           }
         }
       ]
+    },
+    {
+      "id": "workflow",
+      "type": "enum",
+      "label": {
+        "cli": "Workflow",
+        "wizard": "How should agents track work?"
+      },
+      "help": {
+        "cli": "Local Markdown tracker, GitHub issue/PR templates, or neither.",
+        "wizard": "Local files under work/, GitHub templates only, or skip the tracker."
+      },
+      "default": "local",
+      "choices": [
+        {
+          "value": "local",
+          "label": {
+            "cli": "Local",
+            "wizard": "Markdown tracker under work/ (default)"
+          }
+        },
+        {
+          "value": "github",
+          "label": {
+            "cli": "GitHub",
+            "wizard": "Issue and PR templates (no API calls)"
+          }
+        },
+        {
+          "value": "none",
+          "label": {
+            "cli": "None",
+            "wizard": "No tracker files; keep zones only"
+          }
+        }
+      ]
     }
   ],
   "constraints": [
@@ -868,7 +904,7 @@
         "equals": "docker"
       },
       "scripts": {
-        "image:build": "docker build -t yosr-seed-prototype:gate ."
+        "image:build": "docker build -t __seed_projectSlug__:latest ."
       },
       "patches": [
         {
@@ -876,6 +912,13 @@
           "target": "next.config.ts",
           "anchor": "next-config",
           "content": "...(process.env.YOSR_STANDALONE === \"1\" ? { output: \"standalone\" as const } : {}),"
+        },
+        {
+          "op": "insert",
+          "target": "README.md",
+          "anchor": "readme-sections",
+          "source": "features/deploy-docker/snippets/readme-docker.md",
+          "position": "before"
         }
       ]
     },
@@ -901,6 +944,34 @@
         "Dockerfile"
       ]
     },
+    {
+      "id": "deploy-docker-prisma",
+      "description": "Combination overlay: copy Prisma schema before the Docker install stage so postinstall can generate the client.",
+      "when": {
+        "all": [
+          {
+            "option": "deploy",
+            "equals": "docker"
+          },
+          {
+            "option": "orm",
+            "equals": "prisma"
+          }
+        ]
+      },
+      "after": [
+        "deploy-docker",
+        "deploy-docker-npm"
+      ],
+      "patches": [
+        {
+          "op": "insert",
+          "target": "Dockerfile",
+          "anchor": "docker-pre-install",
+          "source": "features/deploy-docker-prisma/snippets/docker-pre-install.Dockerfile"
+        }
+      ]
+    },
     {
       "id": "deploy-docker-postgres",
       "description": "Combination overlay: adds a Postgres service to the compose file.",
@@ -920,11 +991,36 @@
         "deploy-docker"
       ],
       "patches": [
+        {
+          "op": "insert",
+          "target": "compose.yaml",
+          "anchor": "compose-header",
+          "source": "features/deploy-docker-postgres/snippets/compose-header.yaml"
+        },
+        {
+          "op": "insert",
+          "target": "compose.yaml",
+          "anchor": "app-config",
+          "source": "features/deploy-docker-postgres/snippets/app-config.yaml"
+        },
         {
           "op": "insert",
           "target": "compose.yaml",
           "anchor": "services",
           "source": "features/deploy-docker-postgres/snippets/postgres-service.yaml"
+        },
+        {
+          "op": "insert",
+          "target": "compose.yaml",
+          "anchor": "compose-root",
+          "source": "features/deploy-docker-postgres/snippets/compose-volumes.yaml"
+        },
+        {
+          "op": "insert",
+          "target": "README.md",
+          "anchor": "readme-sections",
+          "source": "features/deploy-docker-postgres/snippets/readme-docker.md",
+          "position": "before"
         }
       ]
     }
@@ -1187,13 +1283,13 @@
     },
     {
       "id": "app-pages",
-      "intent": "Pages and layouts for the user's app inside the authenticated app area, composed from shadcn/ui components.",
+      "intent": "Pages and layouts under src/app/**, composed from shadcn/ui. Leave src/app/api/** and auth sign-in/sign-up routes to their own features; this template never creates src/app/(app)/.",
       "paths": {
         "create": [
-          "src/app/(app)/**"
+          "src/app/**"
         ],
         "modify": [
-          "src/app/(app)/**"
+          "src/app/**"
         ]
       },
       "context": [