create-skit 0.1.0

package/templates/base-web/src/app/globals.css

@@ -0,0 +1,534 @@
+@import url("https://api.fontshare.com/v2/css?f[]=satoshi@400,500,700,900&f[]=general-sans@400,500,600&display=swap");
+
+:root {
+  color-scheme: dark;
+  --font-display: "Satoshi", system-ui, sans-serif;
+  --font-body: "General Sans", system-ui, sans-serif;
+  --font-mono: ui-monospace, "SF Mono", "Fira Code", monospace;
+  --ease: cubic-bezier(0.16, 1, 0.3, 1);
+  --radius: 14px;
+  --bg: #09090b;
+  --bg-raised: #111113;
+  --bg-overlay: #18181b;
+  --bg-subtle: #1e1e22;
+  --border: rgba(255, 255, 255, 0.06);
+  --border-hover: rgba(255, 255, 255, 0.12);
+  --text: #f0eef5;
+  --text-secondary: #9490a5;
+  --text-muted: #5e5a70;
+  --text-inverse: #09090b;
+  --accent: #00d4aa;
+  --accent-dim: rgba(0, 212, 170, 0.12);
+  --accent-glow: rgba(0, 212, 170, 0.25);
+  --accent-hover: #00eabc;
+  --danger: #f04e4e;
+  --danger-dim: rgba(240, 78, 78, 0.12);
+  --success: #34c759;
+  --success-dim: rgba(52, 199, 89, 0.12);
+  --warn: #f5a623;
+  --warn-dim: rgba(245, 166, 35, 0.12);
+  --shadow: 0 4px 24px rgba(0, 0, 0, 0.4);
+  --glow: 0 0 40px var(--accent-glow);
+}
+
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+html { -webkit-font-smoothing: antialiased; text-rendering: optimizeLegibility; }
+body { font-family: var(--font-body); font-size: 15px; line-height: 1.6; color: var(--text); background: var(--bg); min-height: 100dvh; }
+a { color: inherit; text-decoration: none; }
+button { cursor: pointer; font: inherit; border: none; background: none; }
+input, textarea, select { font: inherit; }
+::selection { background: var(--accent-dim); color: var(--accent); }
+::-webkit-scrollbar { width: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--border-hover); border-radius: 3px; }
+
+body::before {
+  content: "";
+  position: fixed;
+  inset: 0;
+  z-index: 9999;
+  pointer-events: none;
+  opacity: 0.02;
+  background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.8' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E");
+  background-size: 256px;
+}
+
+@keyframes fade-up { from { opacity: 0; transform: translateY(16px); } to { opacity: 1; transform: none; } }
+@keyframes fade-down { from { opacity: 0; transform: translateY(-8px); } to { opacity: 1; transform: none; } }
+@keyframes shimmer { 0% { background-position: -200% 0; } 100% { background-position: 200% 0; } }
+
+h1, h2, h3, h4 { font-family: var(--font-display); font-weight: 700; line-height: 1.12; letter-spacing: -0.02em; }
+h1 { font-size: clamp(2rem, 5vw, 3.25rem); font-weight: 900; letter-spacing: -0.035em; }
+h2 { font-size: clamp(1.5rem, 3vw, 2.25rem); }
+
+.eyebrow {
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.14em;
+  color: var(--accent);
+}
+
+.lede { font-size: 1.0625rem; line-height: 1.7; color: var(--text-secondary); max-width: 540px; }
+
+.hero-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  margin-top: 28px;
+}
+
+.hero-actions a,
+.subtle-button,
+.ghost-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 11px 22px;
+  font-family: var(--font-display);
+  font-weight: 600;
+  font-size: 0.875rem;
+  color: var(--text-secondary);
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  background: var(--bg-raised);
+  text-decoration: none;
+  cursor: pointer;
+  appearance: none;
+  transition: all 0.2s var(--ease);
+}
+.hero-actions a:hover, .subtle-button:hover, .ghost-button:hover {
+  color: var(--text);
+  border-color: var(--border-hover);
+  background: var(--bg-overlay);
+}
+.hero-actions a:first-child {
+  color: var(--text-inverse);
+  background: var(--accent);
+  border-color: var(--accent);
+}
+.hero-actions a:first-child:hover { background: var(--accent-hover); box-shadow: var(--glow); }
+
+/* ── Blank header ──────────────────────────────────────────────── */
+
+.blank-header {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: 100;
+  padding: 14px 28px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  background: rgba(9, 9, 11, 0.6);
+  backdrop-filter: blur(20px) saturate(180%);
+  border-bottom: 1px solid var(--border);
+  animation: fade-down 0.5s var(--ease);
+}
+.blank-logo {
+  font-family: var(--font-display);
+  font-weight: 900;
+  font-size: 1.0625rem;
+  letter-spacing: -0.03em;
+}
+.blank-nav { display: flex; align-items: center; gap: 6px; }
+.blank-nav a {
+  padding: 8px 16px;
+  font-size: 0.8125rem;
+  font-weight: 500;
+  color: var(--text-secondary);
+  border-radius: 999px;
+  transition: all 0.15s ease;
+}
+.blank-nav a:hover { color: var(--text); }
+.blank-nav-cta { background: var(--accent); color: var(--text-inverse) !important; font-weight: 600; }
+.blank-nav-cta:hover { background: var(--accent-hover); }
+
+/* ── Auth form (Fennec-style) ──────────────────────────────────── */
+
+.auth-container {
+  display: grid;
+  min-height: 100dvh;
+  place-items: center;
+  padding: 32px;
+  position: relative;
+  overflow: hidden;
+}
+.auth-container::before, .auth-container::after {
+  content: "";
+  position: absolute;
+  border-radius: 50%;
+  filter: blur(120px);
+  opacity: 0.3;
+  pointer-events: none;
+}
+.auth-container::before { width: 500px; height: 500px; background: radial-gradient(circle, var(--accent-glow), transparent 70%); top: -180px; right: -80px; }
+.auth-container::after { width: 400px; height: 400px; background: radial-gradient(circle, rgba(91, 141, 239, 0.15), transparent 70%); bottom: -100px; left: -120px; }
+
+.auth-card {
+  width: min(100%, 440px);
+  display: flex;
+  flex-direction: column;
+  gap: 24px;
+  position: relative;
+  z-index: 1;
+  animation: fade-up 0.5s var(--ease);
+}
+
+.auth-brand {
+  font-family: var(--font-display);
+  font-weight: 900;
+  font-size: 1.125rem;
+  letter-spacing: -0.03em;
+  color: var(--accent);
+}
+
+.auth-header h1 {
+  font-size: 1.75rem;
+  margin-bottom: 6px;
+}
+.auth-header p {
+  color: var(--text-secondary);
+  font-size: 0.9375rem;
+  margin: 0;
+}
+
+.auth-social-row {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 10px;
+}
+
+.auth-social-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  padding: 12px 16px;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  color: var(--text);
+  background: var(--bg-raised);
+  font-size: 0.875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  appearance: none;
+}
+.auth-social-btn:hover { border-color: var(--border-hover); background: var(--bg-overlay); }
+.auth-social-btn svg { width: 18px; height: 18px; }
+
+.auth-divider {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  color: var(--text-muted);
+  font-size: 0.8125rem;
+  text-transform: lowercase;
+}
+.auth-divider::before,
+.auth-divider::after {
+  content: "";
+  flex: 1;
+  height: 1px;
+  background: var(--border);
+}
+
+.auth-tabs {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  overflow: hidden;
+  background: var(--bg);
+}
+.auth-tab {
+  padding: 10px 16px;
+  font-family: var(--font-mono);
+  font-size: 0.8125rem;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  text-align: center;
+  color: var(--text-muted);
+  transition: all 0.15s ease;
+}
+.auth-tab:hover { color: var(--text-secondary); }
+.auth-tab.active {
+  color: var(--text);
+  background: var(--bg-raised);
+}
+
+.auth-form { display: flex; flex-direction: column; gap: 16px; }
+
+.auth-field { display: flex; flex-direction: column; gap: 6px; }
+.auth-label {
+  font-family: var(--font-mono);
+  font-size: 0.6875rem;
+  font-weight: 600;
+  letter-spacing: 0.12em;
+  color: var(--text-muted);
+}
+.auth-input-wrap {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 0 14px;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--bg);
+  transition: all 0.2s ease;
+}
+.auth-input-wrap:focus-within { border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-dim); }
+.auth-icon { width: 18px; height: 18px; flex-shrink: 0; color: var(--text-muted); }
+.auth-input-wrap input {
+  flex: 1;
+  padding: 12px 0;
+  border: none;
+  background: none;
+  color: var(--text);
+  font-size: 0.9375rem;
+  outline: none;
+}
+.auth-input-wrap input::placeholder { color: var(--text-muted); }
+.auth-toggle-pw {
+  display: flex;
+  align-items: center;
+  padding: 4px;
+  color: var(--text-muted);
+  cursor: pointer;
+  transition: color 0.15s ease;
+}
+.auth-toggle-pw:hover { color: var(--text-secondary); }
+.auth-toggle-pw svg { width: 18px; height: 18px; }
+
+.auth-submit {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  width: 100%;
+  padding: 14px 24px;
+  margin-top: 4px;
+  font-family: var(--font-display);
+  font-weight: 700;
+  font-size: 0.9375rem;
+  color: var(--text-inverse);
+  background: var(--accent);
+  border: 1px solid var(--accent);
+  border-radius: var(--radius);
+  appearance: none;
+  cursor: pointer;
+  transition: all 0.2s var(--ease);
+  position: relative;
+  overflow: hidden;
+}
+.auth-submit::before {
+  content: "";
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(135deg, transparent 40%, rgba(255, 255, 255, 0.12) 50%, transparent 60%);
+  background-size: 200% 200%;
+  animation: shimmer 3s ease-in-out infinite;
+}
+.auth-submit:hover { background: var(--accent-hover); box-shadow: var(--glow); }
+.auth-submit:disabled { opacity: 0.5; pointer-events: none; }
+.auth-submit-arrow { font-size: 1.125rem; }
+
+.auth-footer {
+  text-align: center;
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  letter-spacing: 0.06em;
+  color: var(--text-muted);
+}
+
+/* ── Legacy compat (billing/email pages still use these) ──────── */
+
+.auth-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  padding: 13px 24px;
+  margin-top: 20px;
+  font-family: var(--font-display);
+  font-weight: 600;
+  font-size: 0.9375rem;
+  color: var(--text-inverse);
+  background: var(--accent);
+  border: 1px solid var(--accent);
+  border-radius: var(--radius);
+  appearance: none;
+  cursor: pointer;
+  transition: all 0.2s var(--ease);
+  position: relative;
+  overflow: hidden;
+}
+.auth-button::before {
+  content: "";
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(135deg, transparent 40%, rgba(255, 255, 255, 0.15) 50%, transparent 60%);
+  background-size: 200% 200%;
+  animation: shimmer 3s ease-in-out infinite;
+}
+.auth-button:hover { background: var(--accent-hover); box-shadow: var(--glow); }
+.auth-button:disabled { opacity: 0.5; pointer-events: none; }
+
+.auth-switch { margin: 0; color: var(--text-secondary); font-size: 0.875rem; }
+.auth-switch a { color: var(--accent); font-weight: 500; }
+.auth-switch a:hover { color: var(--accent-hover); }
+
+.shell {
+  display: grid;
+  min-height: 100dvh;
+  place-items: center;
+  padding: 32px;
+  position: relative;
+  overflow: hidden;
+}
+.shell::before, .shell::after {
+  content: "";
+  position: absolute;
+  border-radius: 50%;
+  filter: blur(120px);
+  opacity: 0.35;
+  pointer-events: none;
+}
+.shell::before { width: 500px; height: 500px; background: radial-gradient(circle, var(--accent-glow), transparent 70%); top: -180px; right: -80px; }
+.shell::after { width: 400px; height: 400px; background: radial-gradient(circle, rgba(91, 141, 239, 0.15), transparent 70%); bottom: -100px; left: -120px; }
+
+.hero {
+  width: min(100%, 640px);
+  padding: 40px;
+  border: 1px solid var(--border);
+  border-radius: 24px;
+  background: var(--bg-raised);
+  position: relative;
+  z-index: 1;
+  animation: fade-up 0.5s var(--ease);
+}
+
+.field { display: flex; flex-direction: column; gap: 6px; }
+.field span { font-size: 0.8125rem; font-weight: 500; color: var(--text-secondary); }
+.field input {
+  width: 100%;
+  padding: 11px 16px;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--bg);
+  color: var(--text);
+  font-size: 0.9375rem;
+  outline: none;
+  transition: all 0.2s ease;
+}
+.field input::placeholder { color: var(--text-muted); }
+.field input:focus { border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-dim); }
+
+.form-error {
+  padding: 12px 16px;
+  background: var(--danger-dim);
+  border: 1px solid rgba(240, 78, 78, 0.2);
+  border-radius: var(--radius);
+  color: var(--danger);
+  font-size: 0.875rem;
+}
+.form-success {
+  padding: 12px 16px;
+  background: var(--success-dim);
+  border: 1px solid rgba(52, 199, 89, 0.2);
+  border-radius: var(--radius);
+  color: var(--success);
+  font-size: 0.875rem;
+}
+
+.demo-banner {
+  padding: 14px 16px;
+  border: 1px solid rgba(245, 166, 35, 0.15);
+  border-radius: var(--radius);
+  background: var(--warn-dim);
+  color: var(--warn);
+  font-size: 0.875rem;
+}
+
+.billing-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+  gap: 14px;
+  margin-top: 24px;
+}
+.billing-card {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 24px;
+  border: 1px solid var(--border);
+  border-radius: 18px;
+  background: var(--bg-raised);
+  transition: all 0.25s var(--ease);
+}
+.billing-card:hover { border-color: var(--border-hover); transform: translateY(-2px); box-shadow: var(--shadow); }
+.billing-card h2, .billing-card p { margin: 0; }
+.billing-card p { color: var(--text-secondary); font-size: 0.875rem; line-height: 1.6; }
+.billing-caption { color: var(--text-muted); font-size: 0.85rem; }
+
+/* ── Pricing section ───────────────────────────────────────────── */
+
+.pricing-section { max-width: 1060px; margin: 0 auto; padding: 80px 28px; }
+.pricing-section > .eyebrow { text-align: center; margin-bottom: 10px; }
+.pricing-section > h2 { text-align: center; margin-bottom: 12px; }
+.pricing-section > .lede { text-align: center; margin: 0 auto 48px; }
+.pricing-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 16px; }
+
+.pricing-card {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+  padding: 32px;
+  border: 1px solid var(--border);
+  border-radius: 20px;
+  background: var(--bg-raised);
+  transition: all 0.25s var(--ease);
+}
+.pricing-card:hover { border-color: var(--border-hover); transform: translateY(-2px); box-shadow: var(--shadow); }
+.pricing-card.featured {
+  border-color: var(--accent);
+  background: linear-gradient(to bottom, var(--bg-raised), var(--accent-dim));
+  box-shadow: 0 0 60px var(--accent-dim);
+}
+.pricing-card .plan-name { font-family: var(--font-display); font-size: 1.125rem; font-weight: 700; margin: 0; }
+.pricing-card .plan-price { display: flex; align-items: baseline; gap: 4px; }
+.pricing-card .plan-price strong { font-family: var(--font-display); font-size: 2.5rem; font-weight: 900; letter-spacing: -0.03em; }
+.pricing-card .plan-price span { color: var(--text-muted); font-size: 0.875rem; }
+.pricing-card .plan-desc { color: var(--text-secondary); font-size: 0.875rem; line-height: 1.5; margin: 0; }
+.pricing-features { display: flex; flex-direction: column; gap: 10px; padding: 0; margin: 0; list-style: none; flex: 1; }
+.pricing-features li { display: flex; align-items: flex-start; gap: 8px; color: var(--text-secondary); font-size: 0.8125rem; line-height: 1.5; }
+.pricing-features li::before { content: "✓"; color: var(--accent); font-weight: 700; flex-shrink: 0; }
+.pricing-cta {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 12px 20px;
+  font-family: var(--font-display);
+  font-weight: 600;
+  font-size: 0.875rem;
+  color: var(--text-secondary);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--bg);
+  cursor: pointer;
+  transition: all 0.2s var(--ease);
+  text-decoration: none;
+}
+.pricing-cta:hover { color: var(--text); border-color: var(--border-hover); }
+.pricing-card.featured .pricing-cta { color: var(--text-inverse); background: var(--accent); border-color: var(--accent); }
+.pricing-card.featured .pricing-cta:hover { background: var(--accent-hover); box-shadow: var(--glow); }
+
+@media (max-width: 640px) {
+  .shell { padding: 20px; }
+  .hero { padding: 28px; }
+  .auth-container { padding: 20px; }
+  .pricing-grid { grid-template-columns: 1fr; }
+}

package/templates/base-web/src/app/layout.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "__PROJECT_NAME__",
+  description: "Generated by Skit"
+};
+
+export default function RootLayout({
+  children
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/base-web/src/app/llms-full.txt/route.ts

@@ -0,0 +1,158 @@
+export function GET() {
+  const content = `# __PROJECT_NAME__ — Full Project Context
+
+> Built with Skit — opinionated Next.js 16 SaaS starter.
+
+---
+
+## Tech Stack
+
+- Framework: Next.js 16.2.x (App Router, React 19, TypeScript 5.9)
+- Database: PostgreSQL + Drizzle ORM 0.44.x
+- Auth: Better Auth 1.x (email/password__AUTH_LLMS_EXTRA__)
+- Billing: __BILLING_LLMS_LINE__
+- Email: __EMAIL_LLMS_LINE__
+- Styling: Tailwind CSS 4
+- Validation: Zod 4 + React Hook Form
+- Testing: Vitest 3.2 (unit) + Playwright 1.55 (E2E)
+- Quality: ESLint 9, Prettier, Husky + lint-staged
+
+---
+
+## Project Structure
+
+\`\`\`
+src/
+├── app/
+│   ├── page.tsx              # Landing / marketing page
+│   ├── dashboard/page.tsx    # Protected dashboard
+│   ├── settings/page.tsx     # Account settings
+│   ├── billing/page.tsx      # Billing management
+│   ├── email/page.tsx        # Email demo
+│   ├── sign-in/page.tsx      # Sign in
+│   ├── sign-up/page.tsx      # Sign up
+│   ├── api/
+│   │   ├── auth/[...all]/route.ts    # Auth API
+│   │   ├── billing/checkout/route.ts # Checkout session
+│   │   ├── billing/portal/route.ts   # Customer portal
+│   │   ├── webhooks/stripe/route.ts  # Stripe webhooks
+│   │   └── email/test/route.ts       # Email test
+│   ├── llms.txt/route.ts    # LLM summary (this file)
+│   └── llms-full.txt/route.ts
+├── lib/
+│   ├── auth.ts               # Better Auth server config
+│   ├── auth-client.ts        # Client auth utilities
+│   ├── auth-session.ts       # Server session helper
+│   ├── db.ts                 # Drizzle client
+│   ├── billing.ts            # Billing provider abstraction
+│   ├── email.ts              # Email client
+│   └── env.ts                # Environment validation (Zod)
+├── db/
+│   ├── schema.ts             # Drizzle table definitions
+│   └── seed.ts               # Demo data seeder
+└── middleware.ts              # Route protection
+\`\`\`
+
+---
+
+## Authentication
+
+Uses Better Auth. Sessions stored in the database.
+
+Server-side session access:
+\`\`\`ts
+import { getSession } from "@/lib/auth-session";
+const session = await getSession();
+if (!session) redirect("/sign-in");
+\`\`\`
+
+Client-side session access:
+\`\`\`ts
+import { useSession } from "@/lib/auth-client";
+const { data: session } = useSession();
+\`\`\`
+
+Protected routes defined in src/middleware.ts:
+- /dashboard, /settings, /billing — redirect to /sign-in if unauthenticated
+
+---
+
+## Database
+
+Drizzle ORM with PostgreSQL. Schema in src/db/schema.ts.
+
+Commands:
+- pnpm db:push — push schema to database
+- pnpm db:migrate — run migrations
+- pnpm db:seed — seed demo data
+- pnpm db:studio — open Drizzle Studio
+
+---
+
+## Billing
+
+Provider abstraction interface:
+- createCheckoutSession() — create a payment session
+- createCustomerPortalSession() — customer self-service portal
+- handleWebhook() — process billing events
+
+Configured via BILLING_PROVIDER env var.
+
+---
+
+## Email
+
+Resend integration. Usage:
+\`\`\`ts
+import { sendEmail } from "@/lib/email";
+await sendEmail({ to: "user@example.com", subject: "Welcome!", html: "<p>Hello</p>" });
+\`\`\`
+
+---
+
+## Environment Variables
+
+All validated via src/lib/env.ts. Never use process.env directly.
+
+Required: DATABASE_URL, BETTER_AUTH_SECRET, BETTER_AUTH_URL
+Billing: STRIPE_SECRET_KEY, STRIPE_PUBLISHABLE_KEY, STRIPE_PRICE_ID, STRIPE_WEBHOOK_SECRET
+Email: RESEND_API_KEY, EMAIL_FROM
+
+---
+
+## Conventions
+
+- Server components by default; add "use client" only when needed
+- All env access through src/lib/env.ts
+- Database queries in server components or server actions
+- Auth checks: middleware for routes, getSession() for pages/API
+- File naming: kebab-case for files, PascalCase for components
+- Imports: use @/ path alias
+- No barrel exports (index.ts re-exports)
+
+---
+
+## Testing
+
+Unit tests: src/**/*.test.ts (Vitest)
+E2E tests: tests/**/*.spec.ts (Playwright)
+
+Commands:
+- pnpm test — run unit tests
+- pnpm test:e2e — run E2E tests
+
+---
+
+## AI Agent Configuration
+
+- AGENTS.md — primary rules for all agents
+- CLAUDE.md — Claude Code specific workflow
+- .cursor/rules/*.mdc — Cursor auto-activated rules
+- .gemini/GEMINI.md — Gemini Code Assist
+- ARCHITECTURE.md — project architecture and extension points
+`;
+
+  return new Response(content, {
+    headers: { "Content-Type": "text/plain; charset=utf-8" },
+  });
+}