building this site
lessons from building a minimal portfolio with astro and mdx
just shipped this portfolio site. here’s what i learned along the way. ⚡
design decisions
i wanted something that felt like a terminal but wasn’t cosplaying as one. the key was:
- monospace font everywhere — geist mono is beautiful
- limited color palette — mostly grays, orange for emphasis
- no images — text-first, content-focused
- generous whitespace — let things breathe
astro is great
if you’re building a content-heavy site, astro is probably the right choice:
npm create astro@latest
what i love:
- zero javascript by default
- mdx support out of the box
- fast builds
- simple mental model
what’s next
some things i want to add:
- dark mode — respect system preferences ✅
- rss feed — for the few who still use readers
- search — once there’s enough content
but for now, shipping beats perfecting.
built with astro, deployed on vercel, written in markdown