Set up your site with an AI agent

Sat, 04 Jul 2026 00:00:00 GMT

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