boilerplate

README.md

@@ -0,0 +1,73 @@
+# 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.
+
+```bash
+pnpm install
+```
+
+2. Copy the example environment file and set a real PostgreSQL connection string plus Better Auth secret.
+
+```bash
+cp .env.example .env
+```
+
+3. Apply the committed migration or generate a local dev database from scratch.
+
+```bash
+pnpm db:migrate
+```
+
+Or for local development:
+
+```bash
+pnpm db:generate
+```
+
+4. Regenerate the Prisma client if needed.
+
+```bash
+pnpm exec prisma generate
+```
+
+5. Run the app.
+
+```bash
+pnpm dev
+```
+
+## Validation
+
+```bash
+pnpm typecheck
+pnpm check
+pnpm build
+```