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

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @yosr-ai/template-next-fullstack
 
+## 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-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,20 @@
+## 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:
+
+```text
+docker compose up --build
+```
+
+Then open http://localhost:3000.
+
+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/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@yosr-ai/template-next-fullstack",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.6",
   "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/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.6",
   "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",
@@ -901,6 +901,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 +948,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"
         }
       ]
     }