Side project / 08

Systems Field Guide

Understand the trade-off.

Overview

Educational engineering content, diagrams, and searchable guides.

Key capabilities

  • Read mental models, practical use cases, common questions, and engineering constraints.
  • Explore the first complete guide comparing PostgreSQL and MongoDB.
  • Search published content through a build-time full-text index.

Under the hood

Technical decisions

Content is structured data

Local MDX collections validate metadata and relationships. Drafts stay out of production routes, search, and sitemaps.

Static by design

Astro emits pages and Pagefind builds search locally. Custom CSS and browser APIs avoid a frontend framework runtime.

Current limitations

The published collection is still small. Spanish translations are not yet authored, and search requires a production build.

Stack

  • Astro
  • TypeScript
  • MDX
  • Pagefind