Astro Deep Dive
A four-part series building a production Astro 5 site from scratch — scaffold, islands, content collections, and Cloudflare deployment.
In this series
- 1 Astro Deep Dive: Scaffolding a Production-Ready Astro 5 Project 12 min read
Most Astro tutorials stop at pnpm create astro. By the time you need TypeScript strict mode, Tailwind 4, and a Cloudflare deployment pipeline enforcing Lighthouse 100, you are patching together Stack Overflow answers. This post gets you production-ready from the first command.
- 2 Astro Deep Dive: The Island Architecture 14 min read
Every client:load directive you add ships JavaScript to every reader. Most of them do not need it. The difference between Lighthouse 100 and 85 is understanding which components need interactivity and choosing the right hydration strategy for each.
- 3 Astro Deep Dive: Content Collections — Schema, Querying, and Type-Safe MDX 12 min read
Your blog has 50 posts and a typo in one date field blows up the whole page. Content Collections catch schema violations at build time — before your readers do. This post covers the Content Layer API, Zod schemas, dynamic routes, and image validation.
- 4 Astro Deep Dive: Deployment, CI/CD, and Lighthouse 100/100 15 min read
Your Astro site builds locally but fails on deploy — Mermaid needs Playwright, edge functions reference process.env, and Lighthouse scores crater. This post configures Cloudflare Pages, GitHub Actions, and Lighthouse CI so deploy day is boring.