@yosr-ai/template-next-fullstack 0.1.0-alpha.0 → 0.1.0-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @yosr-ai/template-next-fullstack
 
+## 0.1.0-alpha.2
+
+### Patch Changes
+
+- A first Yosr Seed run through `create-yosr-seed` keeps the terminal, so the arrow-key menus appear instead of line prompts.
+
+## 0.1.0-alpha.1
+
+### Patch Changes
+
+- An interactive Yosr Seed run closes with the next command when the gate is green, and points at `.seed/report.md` when the project was still written. On a terminal, the written folder, git, and the gate stay inside the prompt rail. The published Yosr Seed package rewrites every bundled `@yosr-ai/engine` import.
+- Generated Yosr Seed projects record the choices made at setup and ask before departing from them. Flat aliases and unit-test paths match the layout, the home page follows the database choice, and standalone output is only for the Docker image build.
+- Generated Yosr Seed projects pass every `ts.typeDefinitions` setting. Flat layout names `src/lib/server/` as the server-infrastructure area, with one level for `db/` and `auth/`.
+
 ## 0.1.0-alpha.0
 
 ### Major Changes

package/README.md

@@ -9,7 +9,7 @@ For template authors; not rendered. Layout follows the template format spec.
 - `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`. `next.config.ts` gets `output: "standalone"` only through the `next-config` anchor. `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`).
+- `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.
 

package/features/api-trpc/files/src/server/api/context.ts

@@ -1,10 +1,8 @@
 import { insertNote } from "@domain/notes/notes-store";
 
-export type ApiContext = {
-  insertNote: typeof insertNote;
-};
-
 /** Request context. Importing the store does not open a database. */
-export function createContext(): ApiContext {
+export function createContext() {
   return { insertNote };
 }
+
+export type ApiContext = ReturnType<typeof createContext>;

package/features/auth-authjs/files/src/app/api/auth/[...nextauth]/route.ts

@@ -3,9 +3,10 @@ import NextAuth from "next-auth";
 
 import { authOptions } from "@server/auth/config";
 
-type RouteContext = { params: Promise<{ nextauth: string[] }> };
-
-async function handler(req: NextRequest, context: RouteContext) {
+async function handler(
+  req: NextRequest,
+  context: { params: Promise<{ nextauth: string[] }> },
+) {
   return NextAuth(req, context, authOptions());
 }
 

package/features/deploy-docker/files/Dockerfile

@@ -8,6 +8,8 @@ ENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0
 COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
 RUN corepack enable && __seed_pmInstallCi__
 COPY . .
+# Standalone output is for this image only. Local `next start` leaves this unset.
+ENV YOSR_STANDALONE=1
 RUN __seed_pmRun__ build
 
 FROM node:24 AS runner

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

@@ -8,6 +8,8 @@ ENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0
 COPY package.json package-lock.json ./
 RUN npm ci
 COPY . .
+# Standalone output is for this image only. Local `next start` leaves this unset.
+ENV YOSR_STANDALONE=1
 RUN __seed_pmRun__ build
 
 FROM node:24 AS runner

package/features/payments-stripe/files/src/server/billing/index.ts

@@ -7,13 +7,6 @@ import {
 } from "./store";
 import { stripeClient } from "./stripe";
 
-export type BillingUpdate = {
-  stripeCustomerId: string;
-  stripeSubscriptionId: string;
-  status: string;
-  priceId: string | null;
-};
-
 function asRecord(value: unknown): Record<string, unknown> | null {
   if (typeof value !== "object" || value === null) return null;
   return value as Record<string, unknown>;
@@ -27,7 +20,7 @@ function stringField(value: unknown, key: string): string | null {
 }
 
 /** Maps a verified subscription or checkout event onto the billing tables. */
-export function billingUpdateFromEvent(event: Stripe.Event): BillingUpdate | null {
+export function billingUpdateFromEvent(event: Stripe.Event) {
   const object: unknown = event.data.object;
   if (event.type === "checkout.session.completed") {
     const stripeCustomerId = stringField(object, "customer");
@@ -66,6 +59,10 @@ export function billingUpdateFromEvent(event: Stripe.Event): BillingUpdate | nul
   return { stripeCustomerId, stripeSubscriptionId, status, priceId };
 }
 
+export type BillingUpdate = NonNullable<
+  ReturnType<typeof billingUpdateFromEvent>
+>;
+
 export async function createCheckoutSession(input: {
   userEmail: string;
   priceId: string;

package/files/src/app/page.tsx

@@ -12,7 +12,7 @@ export default async function HomePage() {
     <main className="mx-auto flex max-w-xl flex-col gap-6 p-8">
       <h1 className="text-2xl font-semibold">__seed_projectName__</h1>
       <p className="text-sm text-muted-foreground">
-        Example feature: notes, stored in __seed_storageLabel__.
+        Example feature: notes, __seed_homeStorage__.
       </p>
       <NoteForm />
       <NoteList notes={notes} />

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yosr-ai/template-next-fullstack",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.2",
   "description": "Yosr Seed next-fullstack template.",
   "license": "MIT",
   "repository": {

package/rules/layout-feature.md

@@ -1,5 +1,5 @@
 Code is grouped **by feature**:
 
 - `__seed_domainDir__/<feature>/` holds that feature's server functions, server actions, zod schemas, and tests. Feature UI lives in `__seed_featureUiDir__/` (on the default tree, the `components/` folder inside the feature).
-- Code shared by several features goes in `__seed_sharedDir__/`. Server-only infrastructure (database client) goes in `__seed_serverDir__/`.
+- Code shared by several features goes in `__seed_sharedDir__/`.
 - Routes in `src/app/` stay thin: they compose feature components and call feature functions.

package/rules/layout-flat.md

@@ -1,5 +1,5 @@
-The structure is **flat** on purpose:
+**Flat** means one folder per area under `src/lib/` and `src/components/`, no deeper nesting.
 
-- Logic and helpers live in `__seed_domainDir__/` (one folder per area is fine, no deeper).
-- Feature UI lives in `__seed_featureUiDir__/`. Routes stay in `src/app/`.
-- Don't add new top-level folders without a reason.
+- Notes logic is `src/lib/notes/`. Shared helpers are `src/lib/shared/`. Feature UI is `src/components/notes/`. shadcn/ui stays in `src/components/ui/`.
+- Routes stay in `src/app/`.
+- `src/lib/server/` is the server-infrastructure area. It has one level for `db/` and `auth/` (`src/lib/server/db/`, `src/lib/server/auth/`). Don't add a folder inside any other area, and don't nest further under `db/` or `auth/`.

package/rules/layout-layer.md

@@ -2,5 +2,5 @@ Code is grouped **by technical layer**:
 
 - Domain logic lives in `__seed_domainDir__/<area>/` (server functions, actions, schemas).
 - Feature UI lives in `__seed_featureUiDir__/`.
-- Shared helpers go in `__seed_sharedDir__/`; shadcn/ui stays in `src/components/ui/`; server-only infrastructure in `__seed_serverDir__/`.
+- Shared helpers go in `__seed_sharedDir__/`; shadcn/ui stays in `src/components/ui/`.
 - Routes in `src/app/` stay thin.

package/rules/project-overview.md

@@ -1,5 +1,5 @@
-`__seed_projectName__` is a Next.js (App Router) + TypeScript app with Tailwind CSS and shadcn/ui, generated by Yosr Seed from `__seed_templateName__@__seed_templateVersion__`. Data: __seed_storageLabel__. API style: server actions.
+`__seed_projectName__` is a Next.js (App Router) + TypeScript app with Tailwind CSS and shadcn/ui, generated by Yosr Seed from `__seed_templateName__@__seed_templateVersion__`. Data: __seed_storageLabel__. API style: __seed_api__.
 
 - Read `docs/architecture.md` before larger changes; it lists the folder map and where new code goes.
-- Import across folders through the path aliases in `tsconfig.json` (`@/`, `@domain/`, `@shared/`, `@server/`, `@ui/`).
-- Don't edit `.seed/`; it records how the project was generated.
+- Import across folders through the path aliases in `tsconfig.json` (__seed_aliasList__).
+- `.seed/` is a record of what Yosr Seed generated. The app never reads it. It is not edited by hand. It can drift from the project after later changes such as adding a database.

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.0",
+  "version": "0.1.0-alpha.2",
   "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",
@@ -59,6 +59,13 @@
         "none": "memory only (no database)",
         "postgres": "Postgres"
       }
+    },
+    "homeStorage": {
+      "fromOption": "database",
+      "map": {
+        "none": "kept in memory",
+        "postgres": "stored in Postgres"
+      }
     }
   },
   "options": [
@@ -868,7 +875,7 @@
           "op": "insert",
           "target": "next.config.ts",
           "anchor": "next-config",
-          "content": "output: \"standalone\","
+          "content": "...(process.env.YOSR_STANDALONE === \"1\" ? { output: \"standalone\" as const } : {}),"
         }
       ]
     },
@@ -954,7 +961,7 @@
           "flat": {
             "pathMap": {
               "@domain": "src/lib",
-              "@shared": "src/lib",
+              "@shared": "src/lib/shared",
               "@server": "src/lib/server",
               "@featureUi": "src/components/notes"
             },