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

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

id	title	status	assignee	created_date	labels	dependencies	references	priority	ordinal
TASK-1	Scaffold the Next.js MVP foundation	To Do		2026-06-03 19:12	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. Create or verify the Next.js App Router project structure.
2. Configure Tailwind, shadcn/ui, path aliases, and shared UI utilities.
3. Add base route groups for internal dashboard and public audit pages.
4. Add environment variable examples and keep all secrets out of source control.
5. Run the initial build/typecheck and record any setup notes.