Set up your site with an AI agent

Clone the starter, point your AI coding agent at it, and go from template to deployed site in an afternoon.

Published on

This starter is built to be handed to an AI coding agent. Every convention it follows is written down in AGENTS.md, so Claude Code, Codex, Cursor, or whatever you use can read the codebase, make it yours, and keep the docs and the site in sync. Here’s the whole loop.

1. Get the code

Use it as a template on GitHub, or start from the CLI:

npm create astro@latest my-site -- --template Zmoki/zmoki-astro-starter
cd my-site
npm install

2. Open it in your AI agent

Point your agent at the repo and let it read the two files that describe the project: AGENTS.md (the technical spec) and SETUP.md (the checklist). Everything site-specific lives in one place — src/site.config.ts — so most of the work is a single, well-scoped file.

3. Make it yours

Work down SETUP.md with your agent. The essentials:

  • Identity — set domain, name, hero copy, and the CTA in src/site.config.ts (and the site in astro.config.mjs).
  • Look — swap the accent color or define your own palette in src/design-tokens.mjs; the whole site and the OG cards follow. Preview at /-/astro/brand/color/.
  • Content — replace this post, add your own resources, and fill in the legal pages. Ask your agent to draft them in your voice.

Because the brand system is a living style guide, you can just say “make the accent green” or “switch the font to Inter” and the agent knows which files to touch and how to keep the guideline honest.

4. Run it

npm run dev

Open the local URL and click through. The site ships with a blog, resources, RSS, analytics, email forms, structured data, and build-time OG images already wired — nothing to bolt on.

5. Verify and deploy

Before you push, run the same checks CI does:

npm run format
npm run check
npm run lint
npm run build

Then connect the repo to your host — the original deploys to Cloudflare Pages on every push to main. That’s it: cloned, rebranded, and live.