ZeroDirs is a starter for building directory sites, built on Astro and Cloudflare. When I launched it, a fair question came up on X: there are already directory templates out there, so why build another one, and why Astro instead of Next.js?
This post is my answer. I will not start from the tools. I will start from the problem and work forward.
Habit Used to Decide the Stack
Most directory sites I see are built on Next.js. I think the reason is simple: people choose the framework they already know.
That used to be a sensible rule. Learning a new framework cost weeks, and shipping fast mattered more than picking the ideal tool.
AI coding agents change this. Claude Code, Codex and Gemini write Astro, Tailwind and SQL as easily as they write React. When an agent does most of the day-to-day coding, your own familiarity with a framework stops being the bottleneck.
So the question changes from "which framework do I know?" to this:
Which foundation is best for this exact product?
What a Directory Site Actually Needs
Forget framework trends for a moment. A directory site has four basic needs:
- Most pages are read-only content. Listing pages, category pages and comparison pages are documents. Search engines crawl them and people read them.
- Search traffic is how you grow. A directory is not a dashboard behind a login. Page speed, clean HTML, structured data and internal links decide whether your pages rank.
- Interactivity is small and local. A listing page only needs JavaScript for a few parts, such as search, filters, a submission form or a checkout button.
- The bill should be close to zero until traffic shows up. A new directory can take months to get indexed. You do not know yet if it will earn anything, so you should not pay a monthly bill while you find out.
Why Next.js Is Not the Best Fit
Next.js is a great framework for interactive apps and dashboards. I have used it many times.
The mismatch is that a directory is mostly static content. Next.js can generate static pages, but it still sends a React runtime to the browser for them. On a site with thousands of generated pages, that is extra weight for pages that only display text and links. You end up using an application framework to serve what is really a content site.
Why Astro on Cloudflare Fits Better
Put the four needs next to each other and Astro and Cloudflare match them well:
- Content pages ship no client-side JavaScript. They are plain HTML. Nothing loads unless you ask for it.
- Islands handle the interactive parts. Search or a filter can be one small interactive piece while the rest of the page stays static.
- Cloudflare covers hosting. Workers, D1 and R2 give you global delivery, a SQL database and file storage in one place, and a small directory fits within the free plan. That keeps the hosting bill at $0 while you test your niche.
Why You Still Need a Starter
If an AI agent can write all this code, why not start from an empty folder?
Because the hard part of a directory is not the pages. It is the plumbing behind them:
- Stripe webhooks that stay correct when Stripe retries or sends the same event twice.
- Paid submissions, featured listings and review queues, where a listing moves from draft to paid to approved to live.
- Programmatic SEO and internal links that do not leave orphan pages or loops once you have thousands of pages.
- Structured data, social preview images and deployment setup, which are easy to forget and slow to fix.
An agent is only as reliable as the project it works in. In an empty folder it will invent its own patterns and can miss details like webhook retries. In a project with clear conventions, an AGENTS.md file, reusable skills and passing tests, it can build real features safely.
What ZeroDirs Is
I built ZeroDirs from this reasoning:
- Choose the stack that fits directory sites: Astro and Cloudflare.
- Package the hard plumbing once, so you do not rebuild it for every directory.
- Organize the repository so AI coding agents can understand it and build on it.
You do not have to keep using the framework you learned years ago. Pick the best foundation for your product, start from a solid starter, and spend your time on the things that actually grow a directory: a good niche, good data and distribution.
- Explore the project and live demo at ZeroDirs.com or check out the ZeroDirs Documentation.

Top comments (0)