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

package/files/README.md

@@ -0,0 +1,18 @@
+# __seed_projectName__
+
+Generated by [Yosr Seed](https://yosr.ai) from the `__seed_templateName__@__seed_templateVersion__` template.
+
+## Commands
+
+| Task | Command |
+| --- | --- |
+| Dev server | `__seed_pmRun__ dev` |
+| Lint | `__seed_pmRun__ lint` |
+| Type-check | `__seed_pmRun__ typecheck` |
+| Unit tests (Vitest) | `__seed_pmRun__ test` |
+| 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`.
+
+<!-- @seed:anchor readme-sections -->

package/files/components.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@shared/utils",
+    "ui": "@ui",
+    "lib": "@shared",
+    "hooks": "@/hooks"
+  }
+}

package/files/e2e/smoke.spec.ts

@@ -0,0 +1,16 @@
+import { expect, test } from "@playwright/test";
+
+test("home page renders", async ({ page }) => {
+  await page.goto("/");
+  await expect(page.getByRole("heading", { level: 1 })).toHaveText(
+    "__seed_projectName__",
+  );
+});
+
+test("adds a note through the server action", async ({ page }) => {
+  const title = `Smoke ${Date.now()}`;
+  await page.goto("/");
+  await page.getByLabel("Note title").fill(title);
+  await page.getByRole("button", { name: "Add" }).click();
+  await expect(page.getByText(title)).toBeVisible();
+});

package/files/eslint.config.mjs

@@ -0,0 +1,21 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+import prettier from "eslint-config-prettier/flat";
+// @seed:anchor eslint-style-imports
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // @seed:anchor eslint-style
+  prettier,
+  globalIgnores([
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+    "playwright-report/**",
+    "test-results/**",
+    "src/generated/prisma/**",
+  ]),
+]);

package/files/gitignore

@@ -0,0 +1,25 @@
+# dependencies
+node_modules/
+
+# next.js
+.next/
+out/
+build/
+next-env.d.ts
+*.tsbuildinfo
+
+# testing
+coverage/
+playwright-report/
+test-results/
+
+# env files (keep .env.example)
+.env
+.env*.local
+
+# prisma client (generated on install)
+src/generated/prisma/
+
+# misc
+.DS_Store
+*.pem

package/files/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  // @seed:anchor next-config
+};
+
+export default nextConfig;

package/files/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "__seed_projectSlug__",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "typecheck": "next typegen && tsc --noEmit",
+    "test": "vitest run",
+    "test:e2e": "playwright test",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "dependencies": {
+    "@radix-ui/react-slot": "1.5.0",
+    "class-variance-authority": "0.7.1",
+    "clsx": "2.1.1",
+    "next": "16.4.2",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "tailwind-merge": "3.7.0",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.64.1",
+    "@tailwindcss/postcss": "4.3.3",
+    "@types/node": "24.19.2",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "eslint": "10.13.0",
+    "eslint-config-next": "16.4.2",
+    "eslint-config-prettier": "10.1.8",
+    "prettier": "3.9.10",
+    "tailwindcss": "4.3.3",
+    "tw-animate-css": "1.4.0",
+    "typescript": "6.0.3",
+    "vite": "8.3.4",
+    "vitest": "5.0.5"
+  }
+}

package/files/playwright.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig, devices } from "@playwright/test";
+
+const port = 3100;
+
+export default defineConfig({
+  testDir: "./e2e",
+  forbidOnly: Boolean(process.env.CI),
+  retries: process.env.CI ? 2 : 0,
+  use: {
+    baseURL: `http://localhost:${port}`,
+    trace: "on-first-retry",
+  },
+  projects: [{ name: "chromium", use: { ...devices["Desktop Chrome"] } }],
+  webServer: {
+    command: "__seed_pmRun__ start",
+    env: { PORT: String(port) },
+    url: `http://localhost:${port}`,
+    reuseExistingServer: !process.env.CI,
+  },
+});

package/files/pnpm-workspace.yaml

@@ -0,0 +1,16 @@
+# pnpm settings (pnpm >= 11 reads them from here; npm ignores this file).
+# Dependency install scripts are denied unless listed as true.
+# esbuild and unrs-resolver ship their binaries as optional platform
+# packages, so their scripts stay false. prisma (preinstall) and
+# @prisma/engines (postinstall) must run so the CLI can generate a client
+# and push a schema.
+#
+# nodeLinker: hoisted — Turbopack's production build is ~2× slower against
+# pnpm's default isolated/symlink layout than against a flat tree (ADR 0009,
+# issue #23). Phantom deps are caught by import-x/no-extraneous-dependencies.
+allowBuilds:
+  "@prisma/engines": true
+  esbuild: false
+  prisma: true
+  unrs-resolver: false
+nodeLinker: hoisted

package/files/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/files/src/app/globals.css

@@ -0,0 +1,68 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+}
+
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/files/src/app/layout.tsx

@@ -0,0 +1,22 @@
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+
+import { Providers } from "./providers";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "__seed_projectName__",
+  description: "Generated by Yosr Seed from next-fullstack",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{ children: ReactNode }>) {
+  return (
+    <html lang="en">
+      <body className="antialiased">
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  );
+}

package/files/src/app/page.tsx

@@ -0,0 +1,21 @@
+import { connection } from "next/server";
+
+import { listNotes } from "@domain/notes/notes-store";
+import { NoteForm } from "@featureUi/note-form";
+import { NoteList } from "@featureUi/note-list";
+
+export default async function HomePage() {
+  await connection();
+  const notes = await listNotes();
+
+  return (
+    <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__.
+      </p>
+      <NoteForm />
+      <NoteList notes={notes} />
+    </main>
+  );
+}

package/files/src/app/providers.tsx

@@ -0,0 +1,15 @@
+import type { ComponentType, ReactNode } from "react";
+// @seed:anchor providers-imports
+
+// Features register app-wide providers here (outermost first). The list is
+// composed below so a feature can add a wrapper with a one-line insert.
+const providers: ComponentType<{ children: ReactNode }>[] = [
+  // @seed:anchor providers
+];
+
+export function Providers({ children }: { children: ReactNode }) {
+  return providers.reduceRight<ReactNode>(
+    (tree, Provider) => <Provider>{tree}</Provider>,
+    children,
+  );
+}

package/files/src/components/ui/button.tsx

@@ -0,0 +1,59 @@
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+import * as React from "react";
+
+import { cn } from "@shared/utils";
+
+const buttonVariants = cva(
+  "inline-flex shrink-0 items-center justify-center gap-2 rounded-md text-sm font-medium whitespace-nowrap transition-all outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:bg-destructive/60 dark:focus-visible:ring-destructive/40",
+        outline:
+          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80",
+        ghost:
+          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2 has-[>svg]:px-3",
+        sm: "h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5",
+        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+        icon: "size-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  },
+);
+
+function Button({
+  className,
+  variant,
+  size,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"button"> &
+  VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+  }) {
+  const Comp = asChild ? Slot : "button";
+
+  return (
+    <Comp
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}
+
+export { Button, buttonVariants };

package/files/src/components/ui/input.tsx

@@ -0,0 +1,21 @@
+import * as React from "react";
+
+import { cn } from "@shared/utils";
+
+function Input({ className, type, ...props }: React.ComponentProps<"input">) {
+  return (
+    <input
+      type={type}
+      data-slot="input"
+      className={cn(
+        "flex h-9 w-full min-w-0 rounded-md border border-input bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none selection:bg-primary selection:text-primary-foreground file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:bg-input/30",
+        "focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50",
+        "aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40",
+        className,
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Input };

package/files/src/features/notes/actions.ts

@@ -0,0 +1,22 @@
+"use server";
+
+import { revalidatePath } from "next/cache";
+
+import { createNote, NoteValidationError } from "./create-note";
+
+/** Server action for the note form. Returns an error message or null. */
+export async function createNoteAction(
+  _previous: string | null,
+  formData: FormData,
+): Promise<string | null> {
+  try {
+    await createNote({ title: formData.get("title") });
+  } catch (error) {
+    if (error instanceof NoteValidationError) {
+      return error.message;
+    }
+    throw error;
+  }
+  revalidatePath("/");
+  return null;
+}

package/files/src/features/notes/components/note-form.tsx

@@ -0,0 +1,32 @@
+"use client";
+
+import { useActionState } from "react";
+
+import { createNoteAction } from "@domain/notes/actions";
+import { Button } from "@ui/button";
+import { Input } from "@ui/input";
+
+export function NoteForm() {
+  const [error, formAction, pending] = useActionState(createNoteAction, null);
+
+  return (
+    <form action={formAction} className="flex flex-col gap-2">
+      <div className="flex gap-2">
+        <Input
+          name="title"
+          placeholder="Write a note"
+          aria-label="Note title"
+          maxLength={120}
+        />
+        <Button type="submit" disabled={pending}>
+          Add
+        </Button>
+      </div>
+      {error ? (
+        <p role="alert" className="text-sm text-destructive">
+          {error}
+        </p>
+      ) : null}
+    </form>
+  );
+}

package/files/src/features/notes/components/note-list.tsx

@@ -0,0 +1,23 @@
+import type { Note } from "@domain/notes/note-schema";
+
+export function NoteList({ notes }: { notes: Note[] }) {
+  if (notes.length === 0) {
+    return <p className="text-sm text-muted-foreground">No notes yet.</p>;
+  }
+
+  return (
+    <ul className="flex flex-col gap-2">
+      {notes.map((note) => (
+        <li key={note.id} className="rounded-md border p-3">
+          <p className="font-medium">{note.title}</p>
+          <time
+            dateTime={note.createdAt.toISOString()}
+            className="text-xs text-muted-foreground"
+          >
+            {note.createdAt.toISOString()}
+          </time>
+        </li>
+      ))}
+    </ul>
+  );
+}

package/files/src/features/notes/create-note.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it, vi } from "vitest";
+
+import { createNote, NoteValidationError } from "@domain/notes/create-note";
+
+describe("createNote", () => {
+  it("stores a trimmed, valid note", async () => {
+    const insert = vi.fn(async (input: { title: string }) => ({
+      id: "1",
+      title: input.title,
+      createdAt: new Date(0),
+    }));
+
+    const note = await createNote({ title: "  Buy milk  " }, insert);
+
+    expect(insert).toHaveBeenCalledWith({ title: "Buy milk" });
+    expect(note.title).toBe("Buy milk");
+  });
+
+  it("rejects an empty title", async () => {
+    const insert = vi.fn();
+
+    await expect(createNote({ title: " " }, insert)).rejects.toBeInstanceOf(
+      NoteValidationError,
+    );
+    expect(insert).not.toHaveBeenCalled();
+  });
+});

package/files/src/features/notes/create-note.ts

@@ -0,0 +1,23 @@
+import { type Note, noteInputSchema } from "./note-schema";
+import { insertNote } from "./notes-store";
+
+export class NoteValidationError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "NoteValidationError";
+  }
+}
+
+/** Validates input and stores a note. Throws NoteValidationError on bad input. */
+export async function createNote(
+  input: unknown,
+  insert: typeof insertNote = insertNote,
+): Promise<Note> {
+  const parsed = noteInputSchema.safeParse(input);
+  if (!parsed.success) {
+    throw new NoteValidationError(
+      parsed.error.issues[0]?.message ?? "Invalid note",
+    );
+  }
+  return insert(parsed.data);
+}

package/files/src/features/notes/note-schema.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+
+export const noteInputSchema = z.object({
+  title: z.string().trim().min(1, "Title is required").max(120),
+});
+
+export const noteSchema = noteInputSchema.extend({
+  id: z.string(),
+  createdAt: z.date(),
+});
+
+export type NoteInput = z.infer<typeof noteInputSchema>;
+export type Note = z.infer<typeof noteSchema>;

package/files/src/features/notes/notes-store.ts

@@ -0,0 +1,17 @@
+import { randomUUID } from "node:crypto";
+
+import type { Note, NoteInput } from "./note-schema";
+
+// In-memory store used when the project has no database. Data resets when the
+// server restarts. The Postgres overlay replaces this file.
+const notes: Note[] = [];
+
+export async function insertNote(input: NoteInput): Promise<Note> {
+  const note = { id: randomUUID(), title: input.title, createdAt: new Date() };
+  notes.unshift(note);
+  return note;
+}
+
+export async function listNotes(): Promise<Note[]> {
+  return [...notes];
+}

package/files/src/shared/utils.test.ts

@@ -0,0 +1,13 @@
+import { describe, expect, it } from "vitest";
+
+import { cn } from "@shared/utils";
+
+describe("cn", () => {
+  it("merges conflicting Tailwind classes, last one wins", () => {
+    expect(cn("px-2 py-1", "px-4")).toBe("py-1 px-4");
+  });
+
+  it("drops falsy values", () => {
+    expect(cn("a", false, undefined, "b")).toBe("a b");
+  });
+});

package/files/src/shared/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/files/tsconfig.json

@@ -0,0 +1,35 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./src/*"],
+      "@domain/*": ["./src/features/*"],
+      "@featureUi/*": ["./src/features/notes/components/*"],
+      "@server/*": ["./src/server/*"],
+      "@ui/*": ["./src/components/ui/*"],
+      "@shared/*": ["./src/shared/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    "**/*.mts",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}

package/files/vitest.config.mts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  resolve: { tsconfigPaths: true },
+  test: {
+    environment: "node",
+    include: ["src/**/*.test.{ts,tsx}", "tests/**/*.test.{ts,tsx}"],
+  },
+});