tech

Tracing the Shape of Code

Sketching an architecture-first approach to building personal sites.

May 12, 20241 min read

Share this article

Spread the word or leave a quick like to keep this thread in your personal rotation.

Tracing the Shape of Code

Designing a personal site starts with the constraints. For this build, the north star is a static export that still feels alive.

Static-first does not mean lifeless—it means intentional about what truly needs to run on the client.

Notes from the planning sketch

  • Contentlayer owns the data model so we keep MDX portable.
  • Light/dark palettes stay in CSS custom properties.
  • Keep every fancy animation behind prefers-reduced-motion checks.[^motion]
export function loadPosts() {
  return sortByDate(allPosts);
}

[^motion]: We owe accessibility more than a quick toggle.