nextjs-hackathon-stack 0.1.27 → 0.1.28

package/README.md

@@ -1,6 +1,6 @@
 # nextjs-hackathon-stack
 
-> Scaffold a full-stack Next.js 15 hackathon starter in one command.
+> Scaffold a full-stack Next.js hackathon starter in one command.
 
 ```bash
 npx nextjs-hackathon-stack my-app
@@ -10,68 +10,57 @@ npx nextjs-hackathon-stack my-app
 
 | Layer | Tool |
 |---|---|
-| Framework | Next.js 15 + App Router |
+| Framework | Next.js 16 + App Router |
 | Database | Supabase (PostgreSQL) |
 | Auth | Supabase Auth (`@supabase/ssr`) |
 | ORM | Drizzle + drizzle-zod (schema + migrations) |
 | Runtime Queries | supabase-js (RLS active) |
 | Client State | TanStack Query v5 |
-| Validation | Zod (auto-generated via drizzle-zod) |
 | Forms | React Hook Form + Zod resolver |
 | UI | shadcn/ui + Tailwind CSS v4 |
-| AI Streaming | Vercel AI SDK + AI Gateway |
-| LLM | Google Gemini 2.0 Flash (`google/gemini-2.0-flash`) |
-| Testing | Vitest + React Testing Library + Playwright |
+| Testing | Vitest + Playwright (100% coverage enforced) |
+| Code Quality | ESLint 9 + Husky + lint-staged |
+| AI Tooling | Cursor rules/agents/skills + Claude Code instructions |
 
 ## Quick start
 
 ```bash
-# Create project
 npx nextjs-hackathon-stack my-app
 cd my-app
 
-# .env.local was created automatically — fill in your keys:
+# Fill in .env.local (created automatically):
 #   NEXT_PUBLIC_SUPABASE_URL      → supabase.com > Project Settings > API
 #   NEXT_PUBLIC_SUPABASE_ANON_KEY → supabase.com > Project Settings > API
 #   DATABASE_URL                  → supabase.com > Project Settings > Database
-#   AI_GATEWAY_URL                → vercel.com > AI > Gateways
 
-npm run dev
+pnpm db:migrate
+pnpm dev
 ```
 
 ## Options
 
-```bash
-npx nextjs-hackathon-stack my-app --skip-install
-```
-
-| Flag | Description |
+| Argument / Flag | Description |
 |---|---|
-| `--skip-install` | Skip `npm install` and `shadcn/ui` init |
+| `[project-name]` | Directory name for the new project |
+| `--skip-install` | Skip `pnpm install` and `shadcn/ui` init |
 
-## Features
+## What the CLI does
 
-- **Auth** — Email/password login with Supabase Auth, Server Actions, protected routes
-- **AI Chat** — Streaming chat with Gemini 2.0 Flash via Vercel AI Gateway (Edge runtime)
-- **TDD-ready** — 100% coverage enforced, Vitest + Playwright preconfigured
-- **Cursor AI** — Rules, agents, and skills preconfigured for the full stack
+1. Copies the template into `[project-name]/`
+2. Replaces `{{projectName}}` placeholders with the actual project name
+3. Installs dependencies with `pnpm`
+4. Initialises shadcn/ui components
+5. Sets up a git repo with Husky pre-commit hooks
 
-## Architecture
+## Requirements
 
-Feature-based structure:
+- Node >= 22
+- pnpm
 
-```
-src/
-├── app/           # Next.js routing + layouts
-├── features/
-│   ├── auth/      # Login form, server actions, session hook
-│   └── chat/      # AI chat (streaming)
-├── shared/
-│   ├── lib/       # Supabase clients, AI
-│   ├── db/        # Drizzle schema + migrations
-│   └── components/# Providers + shadcn/ui
-└── e2e/           # Playwright e2e tests
-```
+## Pre-built features
+
+- **Auth** — Email/password login, logout, `useSession` hook, protected routes
+- **Todos** — Full CRUD with server actions, add form, todo list
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextjs-hackathon-stack",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "description": "Scaffold a full-stack Next.js hackathon starter",
   "type": "module",
   "bin": {

package/template/README.md

@@ -1,6 +1,6 @@
 # {{projectName}}
 
-Full-stack Next.js 16 hackathon starter.
+Full-stack Next.js 16 hackathon starter with pre-built auth and todos.
 
 ## Stack
 
@@ -14,8 +14,8 @@ Full-stack Next.js 16 hackathon starter.
 | State | TanStack Query v5 |
 | Forms | React Hook Form + Zod |
 | UI | shadcn/ui + Tailwind CSS v4 |
-| AI | Vercel AI SDK + MiniMax M2.1 |
 | Testing | Vitest + Playwright |
+| Code Quality | ESLint 9 + Husky + lint-staged |
 
 ## Getting Started
 
@@ -28,17 +28,12 @@ Full-stack Next.js 16 hackathon starter.
 NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co
 NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
 DATABASE_URL=postgresql://postgres.your-project-id:[password]@aws-0-[region].pooler.supabase.com:6543/postgres
-
-# AI — Vercel AI Gateway (default: MiniMax M2.1)
-# Create gateway at: https://vercel.com > AI > Gateways
-AI_GATEWAY_URL=https://gateway.ai.vercel.app/v1/your-team-id/your-gateway-id
-AI_API_KEY=
 ```
 
 ### 2. Apply database migrations
 
 ```bash
-pnpm db:migrate    # aplica las migraciones a la base de datos
+pnpm db:migrate
 ```
 
 ### 3. Run the dev server
@@ -53,12 +48,18 @@ pnpm dev
 pnpm dev             # Start dev server
 pnpm build           # Production build
 pnpm lint            # Lint (0 warnings allowed)
+pnpm lint:fix        # Lint and auto-fix
 pnpm typecheck       # TypeScript check
 pnpm test            # Unit tests
+pnpm test:unit       # Unit tests (verbose)
+pnpm test:watch      # Watch mode
 pnpm test:coverage   # Tests with coverage (100% required)
 pnpm test:e2e        # Playwright e2e tests
-pnpm db:generate     # Generate Drizzle migrations
-pnpm db:migrate      # Apply migrations
+pnpm db:generate     # Generate Drizzle migrations from schema
+pnpm db:migrate      # Apply migrations to database
+pnpm db:pull         # Introspect DB and generate schema
+pnpm db:push         # Push schema directly (dev only)
+pnpm db:studio       # Open Drizzle Studio GUI
 ```
 
 ## Environment Variables
@@ -68,8 +69,6 @@ pnpm db:migrate      # Apply migrations
 | `NEXT_PUBLIC_SUPABASE_URL` | Supabase > Project Settings > API |
 | `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase > Project Settings > API |
 | `DATABASE_URL` | Supabase > Project Settings > Database > Connection string > Session mode |
-| `AI_GATEWAY_URL` | Vercel > AI > Gateways |
-| `AI_API_KEY` | Your AI provider API key |
 | `NEXT_PUBLIC_APP_URL` | Your deployment URL (default: `http://localhost:3000`) |
 
 See `.env.example` for all required variables with comments.
@@ -77,20 +76,27 @@ See `.env.example` for all required variables with comments.
 ## Architecture
 
 Feature-based structure:
+
 ```
 src/
 ├── app/           # Next.js routing + layouts
-├── features/      # auth | chat
+├── features/
+│   ├── auth/      # Email+password login, logout, session hook, protected routes
+│   └── todos/     # CRUD server actions, add form, todo list
 ├── shared/        # lib | db | components/ui
 └── e2e/           # Playwright tests
 ```
 
 Dependency direction: `features/* → shared/*` (never reverse).
 
+## Pre-commit Hooks
+
+Husky runs `vitest --coverage` on every commit. The commit is blocked if coverage drops below 100%.
+
 ## Cursor AI Setup
 
-Cursor rules, agents, and skills are preconfigured in `.cursor/`.
+Cursor rules, agents, and skills are preconfigured in `.cursor/`:
 
-- **Rules**: always-on guardrails for coding standards, architecture, security
-- **Agents**: specialized roles (technical-lead, frontend, test-qa, etc.)
-- **Skills**: repeatable workflows (`/create-feature`, `/create-api-route`, etc.)
+- **Rules** (11): always-on guardrails for coding standards, architecture, security, and more
+- **Agents** (7): specialized roles (technical-lead, frontend, backend, test-qa, etc.)
+- **Skills** (4): repeatable workflows (`/create-feature`, `/create-api-route`, `/review-branch`, `/security-audit`)