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