Skip to content
v4.0 — Open Source & MIT

Build your website with your coding agent.

Download AstroDeck, open it in Claude Code, Codex, Cursor or another coding agent, and describe your site — in one sentence or with a full brief. The agent follows a guided workflow from brief to finished pages, and the result is checked by npm run verify and the bundled vibe2prod audit.

Clone https://github.com/holger1411/astrodeck into a new folder, run npm install and follow its AGENTS.md. Then build my website for: [your business or project in one sentence]. If I give you a brief or a DESIGN.md, put it in brief/ and use it.

Built with:

  • Astro
  • Tailwind
  • React
  • TypeScript
  • shadcn/ui

How it works

From an idea to a live website in four steps

You do not need to know how to code. You describe what you want; the coding agent does the technical work and shows you the result.

  • 1. Get AstroDeck: download it, or paste the prompt above into your coding agent and let it set everything up.
  • 2. Describe your site in one sentence, or put your texts, logo or design notes into the brief/ folder. The agent asks a few questions.
  • 3. The agent removes the demo, adds your name, colors and pages, and shows you a preview.
  • 4. Before it hands the site over, it runs the automatic checks and a launch check, and lists anything still open.
Agent-first

Works with the agent you already use

AstroDeck speaks the open standards: an AGENTS.md index that names the golden rules and the right skill for each task, and portable Agent Skills in .agents/skills/ for building a site, adding pages and sections, theming and removing the demo.

Nothing in the workflow depends on one vendor. Claude Code reads the same files through a one-line CLAUDE.md import and a generated skills mirror, and gets an optional review subagent and guard hook on top.

Supported agents in detail

Claude Code and Codex: tested end to end in 4.0. The others: listed because their vendor docs say they read AGENTS.md and Agent Skills; not run for 4.0. Other agents that read AGENTS.md may work too.

Sections
16
Typed and data-driven
UI Components
11
shadcn/ui + Radix
Agent Skills
6
Incl. vibe2prod
Site Recipes
5
Sitemaps per site type

From an idea to a verified site

A complete Astro foundation plus the workflow, rules and checks your coding agent needs to finish the job.

Start from whatever you have

One sentence in the chat, a PDF, your notes or a design file in the brief/ folder. The agent asks a few questions, tells you what it assumes, and writes everything down in PROJECT.md.

One guided workflow

A built-in guide for the agent covers every step from your first sentence to the finished site: brief, demo cleanup, name and colors, pages, checks and handover.

Your brand in one command

Give it one brand color or a design file, and it creates matching colors for light and dark mode. It stops with a suggestion when text would be hard to read.

Honest content by design

Your own texts fill the page sections. The rules forbid invented testimonials, customer logos and numbers; anything missing becomes a question for you, not filler on the page.

Verified in one command

One command checks code style, types and design rules, builds the site and then checks every page for broken links, missing headings and images without descriptions.

Checked by vibe2prod

vibe2prod is a launch check that comes with AstroDeck. It tests speed, accessibility, search visibility, security and leftover placeholder content, and gives a clear verdict: ready, not yet or blocked.

Frequently asked questions

The short version of everything you might want to know.

Is AstroDeck free?

Yes. AstroDeck is MIT-licensed and free for personal and commercial projects, including the bundled vibe2prod audit (also MIT).

What kind of websites is it for?

Company and service sites, SaaS and product pages, portfolios, personal sites, event pages and blogs. It is deliberately not built for dashboards or app-heavy products.

Which coding agents does it work with?

Claude Code (through CLAUDE.md and a generated skills mirror) and OpenAI Codex were tested end to end: the 4.0 workflow built the eval sites and ended with all checks passing and a READY launch verdict. Cursor, GitHub Copilot, Gemini CLI and Windsurf read AGENTS.md and Agent Skills according to their vendor docs, but were not run for 4.0. The workflow needs nothing tool-specific; Claude Code additionally gets an optional review subagent and a guard hook.

Do I need to know how to code?

No. Describe your site in plain words, answer a few questions and look at the preview; the agent runs the commands. If you do code, AstroDeck is a regular Astro project with typed sections, a site config and scripts you can run yourself.

What happens to the demo content?

The download contains this demo site. The workflow removes it early with npm run starter:clean (with a dry run first), so your site keeps only a minimal home page, the 404 page and, if you want one, the blog.

Does it support multilingual sites?

Not in 4.0. The site config has one language. For several languages, use Astro’s built-in i18n routing on top.

Describe your site. Ship it checked.

Download AstroDeck, open it in your coding agent and say what you want to build. Free and open source under the MIT license.