# Quick start

> Bootstrap a new astro-ignite site in under a minute.

## Prerequisites

- Node 22.12+
- A package manager — pnpm (recommended), npm, yarn, or bun

<Steps>
  <Step title="Scaffold a new site">
    Run the create command with your package manager of choice:

    <CodeGroup>
      <CodeBlock filename="npm" prompt>{`npm create astro-ignite@latest my-site`}</CodeBlock>
      <CodeBlock filename="pnpm" prompt>{`pnpm create astro-ignite my-site`}</CodeBlock>
      <CodeBlock filename="yarn" prompt>{`yarn create astro-ignite my-site`}</CodeBlock>
      <CodeBlock filename="bun" prompt>{`bun create astro-ignite my-site`}</CodeBlock>
    </CodeGroup>

    You'll be asked six questions. Pick or accept defaults; the whole flow takes around fifteen seconds.
  </Step>

  <Step title="Run it">
    <CodeBlock filename="terminal" language="bash">
      {`cd my-site
pnpm install
pnpm dev`}
    </CodeBlock>

    Open the URL printed in your terminal. You should see a working site with a styled hero, a blog with two example posts, a projects showcase, an about page, a working contact form (logs to console in dev), legal pages, a cookie banner, and a dark-mode toggle.
  </Step>

  <Step title="Make it yours">
    Edit these first; grow into the rest over time:

    1. **Brand colors + tokens** in `src/styles/global.css` (`@theme` block)
    2. **Site identity** in `src/config/site.ts` — name, URL, organization, social
    3. **OG image** at `public/og/og-default.png` (placeholder ships)
    4. **Legal pages** in `src/content/legal/{locale}/*.mdx` — placeholders need filling, then **review with counsel before publishing**
    5. **Author bio** in `src/content/authors/jordi.json`
  </Step>
</Steps>

<Callout variant="tip" title="No account signups required">
  In dev, missing env vars fall back to console logs — `pnpm dev` produces a complete working flow
  without any account signup. Set `RESEND_API_KEY` and `PUBLIC_PLAUSIBLE_DOMAIN` only when you go to
  production.
</Callout>

Next, see [Writing content](/authoring) for the components you can drop into any MDX page.
