Blog/

Shipping a portfolio with Astro

Notes from building a content-first site with content collections, MDX, and a tight design system.

  • astro
  • engineering

Astro is a good fit for a portfolio because most of the work is content, not client state.

What I wanted:

  • Static pages that load fast
  • A blog that lives as MDX in the repo
  • A design system that does not fight the content

Content collections give you typed frontmatter and a clean way to list posts. Pair that with a single layout and a small set of tokens, and the site stays honest as it grows.

The hard part is not the framework. It is deciding what belongs on the page and what does not.