webdev-pipeline/backlog/tasks/task-1 - Scaffold-the-Next.js-MVP-foundation.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	references	priority	ordinal
TASK-1	Scaffold the Next.js MVP foundation	In Progress		2026-06-03 19:12	2026-06-03 19:42	mvp foundation nextjs		PRD.md	high	1000

Description

Set up the application foundation for the WebDev Pipeline MVP: Next.js App Router, TypeScript, Tailwind, shadcn/ui, base routing, environment structure, and deployment-aware project conventions for Coolify. This task creates the technical base that all later feature work depends on.

Acceptance Criteria

• #1 Next.js App Router project exists with TypeScript and a working local dev script
• #2 Tailwind and shadcn/ui are configured and at least one shared UI component renders correctly
• #3 Base routes exist for dashboard, login placeholder, and public audit placeholder
• #4 Environment variable conventions are documented for Coolify, Convex, Google, OpenRouter, SMTP, and Rybbit
• #5 A basic smoke test or build command verifies the scaffold compiles

Implementation Plan

1. Migrate package manager to pnpm
2. Verify scaffold
3. Replace starter UI
4. Add base routes
5. Document env conventions
6. Run lint and build

Implementation Notes

Implemented pnpm-based Next.js MVP foundation on branch task-1-scaffold-foundation. Verified pnpm install, pnpm lint, pnpm build, and local route smoke checks for /, /dashboard, /login, and /audit/example. Note: pnpm requires approved build scripts for msw, sharp, and unrs-resolver, recorded in pnpm-workspace.yaml. Build needs network access for next/font/google unless fonts are later self-hosted.