EN
getting-started

Templates

The starting points astro-ignite ships — what each one is for, and live previews of the scaffolded output.

Last updated

astro-ignite ships two templates today. Pick one interactively when you scaffold, or pass --template=<kind> to skip the prompt.

starter

The default. A marketing site with blog and projects collections, a working contact form, full i18n, legal pages, and the full component registry pre-installed in src/components/ui/.

Use it when you’re building a product site, a personal site, a launch page, or anything that needs blog + projects + contact form.

docs

A documentation site built from primitives — sidebar nav, search via Pagefind, on-this-page TOC, code blocks with copy buttons, callouts, breadcrumbs. No Starlight; the whole UI is owned code you can edit.

Use it when you’re shipping documentation for a library, an API, an internal tool, or anything else that wants a left-sidebar / right-TOC layout with search.

Try one without scaffolding

Both previews above are deployed continuously from main. Click through to see exactly what --template=<kind> produces before you scaffold locally.

Scaffold

terminalbash
# Interactive — pick a template, answer prompts
npm create astro-ignite@latest my-site

# Non-interactive — skip the prompt
npm create astro-ignite@latest my-site -- --yes --template=starter
npm create astro-ignite@latest my-site -- --yes --template=docs

What each template ships

Feature starter docs
Blog + projects collections
Contact form (Astro Actions)
Email integration (Resend / SMTP)
Node adapter (@astrojs/node) ✓ (requires Node 22.12+) — (static output)
Full-text search (Pagefind)
Sidebar navigation
On-page table of contents
Component registry (24 atoms)
i18n with parallel routes
Legal pages + cookie banner
Dark mode
JSON-LD / SEO
Sitemap + RSS

Where to next