web-boilerplate/README.md

Web Boilerplate

Generic Next.js Pages Router boilerplate built from the shared stack used in resonate-gallery.

Stack

• Next.js 16 Pages Router
• React 19
• Tailwind CSS 4
• tRPC 11
• Prisma 7 with PostgreSQL
• Better Auth email/password authentication
• Biome

Models

• User
• Session
• Account
• Verification
• Post
• Comment

Routes

• Public: /, /posts, /posts/[postId], /sign-in, /sign-up
• Protected: /dashboard, /account

Bootstrap

1. Install dependencies.

pnpm install

2. Copy the example environment file and set a real PostgreSQL connection string plus Better Auth secret.

cp .env.example .env

3. Apply the committed migration or generate a local dev database from scratch.

pnpm db:migrate

Or for local development:

pnpm db:generate

4. Regenerate the Prisma client if needed.

pnpm exec prisma generate

5. Run the app.

pnpm dev

Validation

pnpm typecheck
pnpm check
pnpm build