The starter kit for AI-assisted websites.
Start from a complete foundation — pages, sections, and a design system — and let Claude Code, Cursor, or any coding agent build your company site, blog, or portfolio. Conventions via AGENTS.md, enforced by built-in guardrails, so AI edits never go off-system.
Clone https://github.com/holger1411/astrodeck as the foundation for my new website. Install the dependencies, read AGENTS.md, start the dev server, and give me a short tour of the project. Built for AI coding assistants
AI without a system produces slop — hardcoded colors, broken dark mode, random spacing. AstroDeck gives your coding agent a real operating environment instead: conventions via the AGENTS.md standard (used by 60,000+ open-source projects, stewarded by the Linux Foundation), so every tool in the grid knows your project's patterns before it writes a single line.
And the rules are enforced, not just written down: a convention guard hook blocks off-system edits before they reach your code, and one command checks every design convention at once. Claude Code gets the deepest integration — a dedicated agent with seven domain skills that warns about security, accessibility, and SEO issues proactively.
- Sections
- 16
- Hero, pricing, FAQ, team & more
- UI Components
- 11
- shadcn/ui + Radix
- Example Pages
- 11
- SaaS, portfolio, blog & more
- Lighthouse
- 100
- Accessibility, Best Practices & SEO
More than a theme, calmer than an AI builder
A complete website foundation — plus the operating layer your AI assistant needs to stay on track.
For Real Websites
Company sites, blogs, portfolios, landing pages — with working example pages for each. Deliberately not built for dashboards or app-heavy products.
AI Guardrails Built In
A convention guard hook blocks off-system edits — hardcoded colors, deprecated patterns — before they ever reach your code.
One Design System
OKLCH color tokens, spacing, and typography defined once. Dark mode included — and your AI assistant cannot break it.
Docs for Humans & AI
Every task is documented two ways: tell your coding assistant what you want, or follow the manual steps yourself.
Quality Checks in One Command
npm run check:kpis verifies colors, alt texts, meta descriptions, and deprecated imports. Lighthouse scores of 99-100 out of the box.
Astro Performance
Static HTML with islands architecture: fast loads, clean SEO, sitemap and RSS included — what content sites actually need.
Frequently asked questions
The short version of everything you might want to know.
Is AstroDeck free?
Yes. AstroDeck is MIT-licensed and completely free — for personal and commercial projects, forever.
What kind of websites is it for?
Company and marketing sites, blogs and editorial sites, portfolios, and landing pages. It is deliberately not built for dashboards or app-heavy products.
Which AI tools does it work with?
Any tool that supports the AGENTS.md standard: Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI, Windsurf, Zed, Aider, and more. Claude Code gets the deepest integration — a dedicated agent, domain skills, slash commands, and the convention guard hook.
Can I use it without AI?
Absolutely. AstroDeck is a normal, well-documented Astro starter kit. Every task in the docs is shown two ways: with AI and manually.
Do I need to know Astro?
It helps, but it is not required. If you work with an AI assistant, it knows the conventions from AGENTS.md and does the heavy lifting. If you prefer to code yourself, the docs walk you through every task.
How opinionated is it?
There is one design-token system (OKLCH colors, spacing, typography) and a set of conventions — that is what keeps AI output consistent. Everything is overridable: your own rules go in PROJECT.md, your own brand goes in globals.css or a DESIGN.md.