Building a Tested, High-Performance Docs Site with Thally (and What It Taught Me About Modern DX)
When I set out to build the JSON Server Field Guide βan interactive, companion guide for [email protected] βI committed to a foundational principle:
Every behavioral statement in the documentation must be backed by ground-truth, recorded HTTP fixtures.
No assumptions, no guessing, and no blindly repeating outdated v0.17 patterns.
To bring this vision to life, I chose Thally , a modern, Next.js 16 (Turbopack)-powered documentation framework purpose-built for speed, clean architectural ownership, and native AI-agent readiness.
In this article, I want to share a transparent, end-to-end walkthrough of building this site from scratch with Thally: from scaffolding and content modeling to authoring client-side interactive MDX consoles, running CI quality gates, and deploying to production.
Along the way, I will also share the real-world engineering hurdles I encounteredβand how Thallyβs standard Next.jsβ¦