Initialize Next.js project
Scaffold Next.js 16 with App Router, TypeScript, Tailwind CSS 4, and shadcn/ui (New York style).
Establish a modern, type-safe fullstack foundation with a complete component library.
Wire design tokens into globals.css
Define the approved palette (dark navy #0B1220, surface #111A2E, border #1E2A44, accent #3B82F6) as CSS variables mapped to Tailwind theme tokens. Dark default, light variant for reading.
Single source of truth for the visual identity, switchable at runtime via class.
Theme provider + toggle
Wrap the app in next-themes ThemeProvider with attribute="class", defaultTheme="dark". Toggle uses CSS-based icon swap (no mounted state) to satisfy React 19 effect rules.
Dark/light theme switching without hydration mismatch or effect cascades.
Foundation verification page
Single page rendering palette swatches, typography scale, technology stack cards, and phase roadmap with status indicators. Responsive (mobile/tablet/desktop).
Prove the design system works before any feature development begins.
Sticky-footer layout pattern
Root layout uses min-h-screen flex flex-col with mt-auto on footer. Footer pins to viewport bottom on short pages, pushes down naturally on long pages.
Consistent layout behavior across all page lengths and viewport sizes.
Project documentation
README.md (project overview, setup, structure), docs/ARCHITECTURE.md (decisions, module boundaries, security), docs/ROADMAP.md (phase-by-phase acceptance criteria).
Capture every approved decision so future work never re-litigates them.
GitHub Actions CI workflow
CI runs lint + type-check + two build jobs (standalone for sandbox/home VM, cloudflare for static export). Concurrency group cancels stale runs. Verifies out/index.html exists after static export.
Prevent silent breakage of either deployment target on every push.
Cloudflare Pages deployment config
wrangler.toml configured for static export. next.config.ts uses conditional output: "export" when BUILD_TARGET=cloudflare, "standalone" otherwise. Images unoptimized in static mode, trailing slashes enabled.
Single codebase deploys as static to Cloudflare (P0) or as Node app to home VM (P1B+).
Prisma schema placeholder
schema.prisma with SQLite datasource (dev only). No models yet - models are added per phase when approved. Comments document which models belong to which phase.
Database layer ready for activation without premature model definitions.
Git repository initialized
Clean commit history with semantic messages. .gitignore excludes sandbox files, env files, build artifacts. .env.example committed as template.
Version-controlled foundation ready for collaborative development and CI.
Header / navigation
Site title, primary nav (Home, Expertise, Activities, Projects, Academy, Contact), theme toggle, GitHub link. Mobile menu collapses below sm breakpoint using shadcn Sheet.
Establish the navigation pattern that persists across all phases.
Hero section
Name (placeholder), professional title, biography paragraph, profile photo placeholder (initials avatar), professional links (LinkedIn, GitHub, email).
Present the owner professional identity at first glance.
Technical expertise grid
9 categories: VMware, Nutanix, SAN/Pure Storage, Linux/Windows Server, Exchange/AD, networking, backup/DR, monitoring, automation/security. Each with icon, title, short description.
Communicate the breadth of enterprise infrastructure expertise visually.
Recent activities preview
3 most recent items (articles, updates, project announcements). Static placeholders for now; powered by database in Phase 1C.
Show the platform is active without building the publishing system yet.
Projects preview
2-3 featured projects with description, technologies list, and external links. Documentation-style layout, not card-grid marketplace.
Showcase technical work without looking like a course marketplace.
Academy preview
Documentation-oriented preview of the future training environment with clear "coming in Phase 2" indicator. Tree-style navigation hint, not course cards.
Set expectations for the training platform without pre-announcing features.
Contact section + footer
Professional email, external profiles. Contact form is display-only until Phase 1B. Footer with copyright, technology attribution, navigation links. Sticky per layout requirement.
Complete the public surface area; provide contact path without backend.
Content constants file
src/lib/content/homepage.ts containing all placeholder content as typed exports. Shape mirrors future Prisma models so Phase 1B migration is a 1:1 swap.
Make the Phase 1B database migration trivial - no component restructuring.
Responsive design verification
Mobile-first with sm/md/lg/xl breakpoints. Touch-friendly 44px minimum targets. Test at 375/768/1280px. Lighthouse: Performance >=90, Accessibility >=95, Best Practices >=95, SEO >=90.
Verify the design holds across all device classes before adding backend complexity.