The Best Astro Directory Themes in 2026

“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 in this category, and you usually find out which end you needed long after the site is live.

Directory sites are one of the best use cases for Astro: content-heavy, SEO-critical, mostly static. Curated lists of tools, apps, agencies, restaurants. But the themes that build them are not interchangeable.

Disclosure up front: I built Almanac — the only paid theme 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, up to ~200 listings
JSON dataset	Edit one file, redeploy	Small fixed lists, design-first sites
Database (D1, Turso, Postgres…)	Admin UI, no redeploy	Submissions, monetization, 200+ listings

Markdown and JSON are wonderful until the day you need user-submitted listings, or want a non-technical collaborator editing 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#

Free · GitHub · Demo

Minted Directory by Mark Bruderer is the strongest free starting point. Listings are Markdown files with frontmatter, 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, which is a sensible nod to how directories actually make money.

Choose it if: you’re the only editor, your listing count is in the dozens-to-low-hundreds, and you’re comfortable with 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. Worth knowing before you commit to it: the last push to the repo was April 2025, and the demo still runs Astro 5. Nothing is broken, but you’ll be the one upgrading it.

Directory (New Design File) — best minimal JSON starter#

Free · GitHub · Demo

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; that’s 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, and without 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 SQLite database instead of the repo — serverless, and effectively free at small scale. 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 carries 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.

Head to head#

	Minted Directory	Directory (New Design File)	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

Or: build it yourself#

Astro’s content collections make a from-scratch Markdown directory a 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, plus a companion piece on what a directory site actually costs to run.

Two details worth building in early if you go the DIY route. Directories live and die by how their listing pages look when shared, and generating a per-listing Open Graph image at build time takes a single endpoint file: how to do it with Satori. They also lean harder on structured data than most sites, since a listing page is exactly the shape search engines want marked up — the JSON-LD that still earns you something covers which types are left.

And whichever data layer you land on, the whole thing still has to ship somewhere: deploying a static Astro site to Cloudflare Workers is the path all three themes here can take.

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: you need a database-backed theme. That’s Almanac, with the bias I declared at the top.

Whichever you pick, start from the data-layer question at the top of this page. It’s the one choice you can’t cheaply reverse later, and if you’re genuinely unsure, start with Minted Directory: outgrowing it is a good problem to have, and moving Markdown into a database is far easier than the reverse.