# FAQ

> What evaluators and first-week buyers ask, answered in a few sentences each.

You are reading one page of the ZeroDirs documentation. ZeroDirs is an Astro + Cloudflare Workers starter for directory sites: every page is rendered to static HTML at build time, the site ships no client JavaScript outside `/search/`, and one file — `site.config.ts` — carries roughly 80% of the customisation.

Two things to hold on to before you act on anything below:

- `site.config.ts` is validated by a zod schema with ten cross-field rules. After any edit to it, run `pnpm check:config`; every problem is reported as `site.config.ts › <path>: <message>` and the whole file is checked at once.
- The repository ships its own `AGENTS.md` with eighteen hard rules, and a machine-checked test suite behind them. If you are working inside a ZeroDirs project, read that file first — it overrides anything general you infer from this page.

Source: https://zerodirs.com/docs/about/faq/

---

Price, refund window and seat count: the [terms page](https://zerodirs.com/legal/terms/) and the
[pricing section](https://zerodirs.com/#pricing), not here.

## Before you buy

### What am I actually buying?

Source you own: one Astro project, delivered as private Git repository access plus every version
published to it. No licence key, runtime check, ZeroDirs API or subscription. The access goes to
the GitHub account you connect right after paying; moving it to another account later is one
email. [What you are buying](https://zerodirs.com/docs/),
[Your repository access](https://zerodirs.com/docs/start/repository-access/).

### Can I use it for client work?

Yes. Build end products for clients and deliver each one to its client, including the parts of
the starter it contains; the client may run and modify it. A client may not use the starter to
build further, separate sites without a licence of their own. [Licence](https://zerodirs.com/docs/about/licence/).

### How many sites can I build?

Unlimited end products, yours or other people's, free or paid; a paid or subscription directory
counts. One purchase covers one person or one company; each further company or independent
developer needs a licence of its own. [Licence](https://zerodirs.com/docs/about/licence/).

### Can I sell a template or starter made from it?

No. Building a directory is permitted; selling the means to build one is not. A starter kit,
template, theme, code generator or hosted directory builder derived from or substantially based
on the starter is a competing product. [Licence](https://zerodirs.com/docs/about/licence/).

### Is there a refund?

Yes, a full one, no questions asked, within the window on the terms page; ask by email.
Repository access is revoked automatically when the refund is issued, and the licence ends.
[Terms](https://zerodirs.com/legal/terms/), [Your repository access](https://zerodirs.com/docs/start/repository-access/).

### Do I need a paid Cloudflare plan?

Not to host it: static pages and assets are free and unmetered; the first limit you meet is the
static file count per version. Only email through Cloudflare Email Sending needs Workers Paid;
Resend is the free-plan alternative. [Cost and limits](https://zerodirs.com/docs/run/cost-and-limits/),
[Email](https://zerodirs.com/docs/submissions/email/).

### What is not included?

Bring your own hosting and its cost, Stripe account and email provider. Absent by design:
passwords and profiles, a rich admin UI, reviews and ratings, a multi-language build, a CMS,
analytics. [What you are buying](https://zerodirs.com/docs/).

## In the first week

### Can I keep the demo listings?

They describe real third-party products: the names belong to their owners, and ZeroDirs wrote the
descriptions for evaluation only, not licensed to you for publication. `pnpm content:reset --yes`
deletes the demo listings and their logos from a database and the demo posts;
`pnpm content:use ai-tools --yes` puts the demo back from `seed/datasets/`. The initial-letter
logo tiles in the dataset's `logos/` are part of the starter.
[Make it yours](https://zerodirs.com/docs/start/make-it-yours/).

### What must I replace before I publish?

Outside `site.config.ts`:

- `public/favicon.svg`, also the header logo
- `public/og-default.png`, regenerated by `pnpm og:default`
- the editorial paragraphs in `src/pages/about.astro`
- `seo.twitterHandle` and `site.social`, still `zerodirs`

[Make it yours](https://zerodirs.com/docs/start/make-it-yours/).

### Do I have to keep the Built with ZeroDirs link?

No. `site.builtWith` defaults to `true` and renders the footer link; `false` removes it. Not a
licence condition. [Configuration reference](https://zerodirs.com/docs/configure/reference/#site).

### Can an agent set it up for me?

Yes; the licence permits AI coding assistants on your own sites and forbids only training a model
on the starter. The starter ships `AGENTS.md` and a set of skills, and the `go-live` skill walks
an agent through the steps `pnpm cf:setup` leaves to you.
[Working with an agent](https://zerodirs.com/docs/agents/overview/), [Editor setup](https://zerodirs.com/docs/agents/editor-setup/),
[Prompts](https://zerodirs.com/docs/agents/prompts/).

### Can my contractor or teammate work in the repository?

Employees and contractors may use the starter on your end products; one whose engagement ends must
delete their copies. Sharing repository access, download links or credentials outside the Licensee
is not allowed. How a contractor receives the files is not covered, so email support.
[Licence](https://zerodirs.com/docs/about/licence/).

## Running it

### What happens when I pull an update?

A normal `git pull` or merge from the starter's repository. No release edits `site.config.ts`,
`src/content/` or `public/`, and the changelog names structural changes under Changed and Removed;
read those before you pull. Migrations only add tables, columns and indexes, so an older Worker
keeps working against a newer database. [Updates](https://zerodirs.com/docs/about/updates/), [Changelog](https://zerodirs.com/docs/about/changelog/).

### What happens when a Cloudflare quota runs out?

- Static pages: unmetered, always up.
- Request quota: click counts drop silently, links still work.
- Email cap: the submission is stored, the notification waits in the outbox for a retry.
- File budget or build minutes: the build fails, the last good version stays live.

[Cost and limits](https://zerodirs.com/docs/run/cost-and-limits/).

### How do I get support?

Email support comes with the licence, best-effort. Write to `hi@zerodirs.com` with the version
from `CHANGELOG.md` and the full output of the failing command, including the lines above the
error. [Troubleshooting](https://zerodirs.com/docs/run/troubleshooting/).

## Related

- [Licence](https://zerodirs.com/docs/about/licence/) — The LICENSE file in plain words.
- [Updates](https://zerodirs.com/docs/about/updates/) — What a release touches, and how to pull one.
- [Changelog](https://zerodirs.com/docs/about/changelog/) — Every release and what it changed.
- [What you are buying](https://zerodirs.com/docs/) — What ships, and what it does not.
