Astro Blog Engine
A shareable Astro blog package with posts, projects, tag-based navigation, search, Mermaid diagrams, and built-in theming.
A complete blog engine extracted from this site. One package, five minutes to a working blog.
What it does
Drop it into any Astro project and you get:
- Posts and Projects - Two content types out of the box, each with their own layouts and listing pages
- Tag-based navigation - Labels connect related content across posts and projects
- Client-side search - Pagefind-powered search with Cmd+K hotkey
- Mermaid diagrams - Import the component in MDX and drop in flowcharts, sequence diagrams, whatever
- Dark mode - System preference detection plus a toggle, with OKLCH colors that work in both modes
Why we built it
We kept rebuilding the same blog features across projects. Content collections, search, theme switching, related content - same patterns every time.
So we extracted it into a package. Now we can spin up a new blog in minutes instead of hours, and improvements to one site benefit all of them.
What’s next
Open sourcing the package is on the roadmap. For now it powers the blogs in this monorepo, but we’d like to get it polished enough to publish properly.