← Back to Index7 min read
EngineeringPublished on 2026-10-12
Building My New Portfolio: Architecture & Design Systems
A deep dive into setting up Next.js App Router, Tailwind v4 class-based dark mode, and zero-latency theme transitions without third-party bloat.
#Next.js#Tailwind CSS#Design Systems
Document Cover Asset
/building-portfolio-architecture
When embarking on a new personal website build, the goal is often simplicity clashing with production readiness. This guide outlines how we structured the core infrastructure.
By centralizing global state into a unified SiteContext and strictly isolating root layout tags, we eliminated hydration warnings and hook-order bugs completely.
Tailwind CSS v4 provides exceptional speed, allowing custom class variants like dark mode to be cleanly toggled with instant 0ms painting feedback.
💡 Architecture Note:This block is structured for effortless extension when connecting directly to Notion database blocks or external notebook markdown sources later.
← Return to all articlesSajjad Hasan • 2026