Comparison
The Best Astro Directory Themes in 2026 (Free & Paid)
Directory websites — curated lists of tools, apps, agencies, restaurants, anything — are one of the best-fit use cases for Astro: they’re content-heavy, SEO-critical, and mostly static. But “Astro directory theme” covers everything from a markdown starter you can deploy in an hour to a database-backed product with an admin panel. Picking the wrong end of that spectrum is the most common (and most expensive) mistake.
Disclosure up front: I’m the developer of Almanac, one of the paid themes in this list. I’ll flag where the free options are genuinely the better choice — because for plenty of projects, they are.
The one decision that matters: where do your listings live?
Before comparing themes, decide how listings get into the site. Everything else — pricing, styling, features — is secondary to this:
| Data layer | Editing workflow | Best for |
|---|---|---|
| Markdown files | Git commit per listing | Solo curators, < ~200 listings |
| JSON dataset | Edit one file, redeploy | Small fixed lists, design-first sites |
| Database (D1, SQLite…) | Admin UI, no redeploy | User submissions, monetization, 500+ listings |
Markdown and JSON are wonderful until the day you want user-submitted listings or a non-technical person updating content. At that point you either bolt a CMS onto a static theme or move to a database-backed one. If you know submissions are on your roadmap, factor that in now.
With that framing, here are the themes worth your attention in 2026.
Minted Directory — best free markdown option
Minted Directory by Mark Bruderer is the strongest free starting point. Listings are markdown files with front-matter, so your whole directory lives in the repo and deploys anywhere static files do. It ships with SEO and programmatic-SEO (pSEO) patterns out of the box, dark/light mode, tag filtering, and support for sponsored/promoted listings — a sensible nod to how directories actually make money. It has real production deployments behind it (e.g. bestmeditationapps.com).
Choose it if: you’re the only editor, your listing count is in the dozens-to-low-hundreds, and you’re comfortable in git.
Limits: every content change is a commit and redeploy; no admin UI; accepting public submissions means wiring up forms and a review workflow yourself.
Directory (New Design File) — best minimal JSON starter
Directory takes an even simpler approach: your entire dataset is JSON, and the theme renders it into a clean, dark/light themed listing site. The demo (riseofmachine.com, an AI tools directory) shows exactly what you get. There’s pleasingly little machinery here — which is the point.
Choose it if: you want a design-forward, hand-curated list where you control every entry, and you’d rather edit one JSON file than manage a content pipeline.
Limits: the same static-workflow ceiling as markdown, minus markdown’s per-entry rich content. Detail pages and long descriptions get awkward as the dataset grows.
Almanac — best for database-backed directories (mine)
$69 · Live demo · Get it on Gumroad
Almanac is my answer to the ceiling both free options hit: it’s a directory theme for Astro + Cloudflare Workers + D1, so listings live in a real (but serverless, and effectively free at small scale) SQLite database instead of the repo. Browsing pages are static and fast; search, submissions, and management run on the Worker.
What that buys you in practice:
- An admin panel — add, edit, approve, and feature listings from the browser. No redeploy, no git, safe to hand to a non-technical collaborator.
- Public submissions with a review queue, so the directory can grow itself.
- Monetization primitives — featured slots and category placement are first-class, not a CSS hack.
- One-stack deployment — everything (site, database, search) lives on Cloudflare; the demo runs 60 listings across 8 categories on the free tier.
Choose it if: the directory is a product — you plan to take submissions, sell featured placements, or run more listings than you want to manage as files.
Limits: it’s paid, and it’s Cloudflare-shaped. If you can’t or won’t run on Cloudflare (D1 is the data layer), the free static options above are a better fit. Simple five-page curated lists don’t need a database — don’t buy one.
Or: build it yourself
Astro’s content collections make a from-scratch markdown directory a very reasonable weekend project, and it’s the best way to learn the patterns these themes package up. I wrote a full walkthrough of the database-backed variant on the Almanac blog: How to build a directory website with Astro, Cloudflare Workers, and D1 — and a companion piece on what a directory site actually costs to run.
Head to head
| Minted Directory | Directory (NDF) | Almanac | |
|---|---|---|---|
| Price | Free | Free | $69 |
| Listings stored in | Markdown | JSON | D1 (SQLite) |
| Admin panel | — | — | ✓ |
| User submissions | DIY | DIY | ✓ built-in |
| Featured/sponsored slots | ✓ basic | — | ✓ built-in |
| Update without redeploy | — | — | ✓ |
| Hosting | Anywhere static | Anywhere static | Cloudflare |
| Best at | Free markdown SEO | Minimal curated lists | Directory-as-a-product |
The bottom line
- Hand-curated list, one editor, git-native: start with Minted Directory — it’s free and genuinely good.
- Small, design-led, fixed dataset: Directory by New Design File keeps it minimal.
- Submissions, admin, monetization — a directory you intend to run as a business: that’s the gap Almanac exists to fill.
Whichever you pick, you’ll end up with a directory that’s static-fast where it counts — which is exactly why Astro has become the default choice for this category of site.