nextjs-hackathon-stack

Scaffold a full-stack Next.js hackathon starter in one command.

npx nextjs-hackathon-stack my-app

What you get

| Layer | Tool | |---|---| | 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 | | Forms | React Hook Form + Zod resolver | | UI | shadcn/ui + Tailwind CSS v4 | | Testing | Vitest + Playwright (100% coverage enforced) | | Code Quality | ESLint 9 + Husky + lint-staged | | AI Tooling | Cursor rules/agents/skills + Claude Code instructions |

Quick start

npx nextjs-hackathon-stack my-app
cd my-app

# 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

pnpm db:migrate
pnpm dev

Options

| Argument / Flag | Description | |---|---| | [project-name] | Directory name for the new project | | --skip-install | Skip pnpm install and shadcn/ui init |

What the CLI does

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

Requirements

• Node >= 22
• pnpm

Pre-built features

• Auth — Email/password login, logout, useSession hook, protected routes
• Todos — Full CRUD with server actions, add form, todo list

License

MIT