siteblaze

AI picks sections, not code. Clean React. Free. Yours.

npx siteblaze generate "Syncly — a SaaS project tracker for remote teams"

No browser. No subscription. No blank canvas. Just a complete, runnable React + Tailwind project you own — or tweak it live in the browser and download when you're happy.

Why siteblaze?

• AI picks the sections, not the code — your prompt decides the layout, copy, colors, and section order. The component library is fixed and vetted; the AI fills the content
• One command → fully scaffolded React project with real, prompt-specific content and appropriate sections
• Free tier — races multiple OpenRouter free models in parallel; first valid response wins. No subscription, no account required
• You own every file — plain git repo, no runtime dependency, no lock-in

Install

npm install -g siteblaze
# or run without installing:
npx siteblaze generate "your prompt"

Requires Node.js ≥ 20 and a free OpenRouter API key.

Usage

# Generate a project (prompts for framework, UI library, package manager)
siteblaze generate "Vault — a fintech app for wealth management"

# Open a live browser editor first, download when happy
siteblaze generate "Vault — a fintech app for wealth management" --preview

# Skip all prompts with sensible defaults
siteblaze generate "Orbit — SaaS project tracker" --yes

# Next.js + shadcn/ui, no hero image
siteblaze generate "Alex Rivera — freelance designer portfolio" --framework next --ui shadcn --no-image

# Use your own paid OpenRouter model
SITEBLAZE_MODELS=anthropic/claude-opus-4 siteblaze generate "..."

# Save API key — also auto-caches the latest free model list
siteblaze auth

# See active models / refresh from OpenRouter
siteblaze list-models
siteblaze list-models --refresh

# Re-open a --preview session (history is only saved for --preview, not scaffold)
siteblaze open

Preview mode

Add --preview to open a browser editor before any files are written to disk:

siteblaze generate "Vault — a fintech app for wealth management" --preview

The editor opens automatically at http://localhost:3000. On the left you'll find a settings panel with:

| Setting | Options | |---|---| | Site name | Free text — also sets the zip filename and project folder | | Theme | Light · Dark · Midnight | | Font | Sans-serif · Serif · Monospace | | Primary color | Color picker + hex input | | Secondary color | Color picker + hex input | | Theme toggle | Show/hide the theme switcher button on the page | | Sections | Add, delete, and reorder sections; hit ↻ on any section to AI-regenerate its content |

The raw JSON is also editable in the panel for advanced changes to section content.

Changes apply to the live preview automatically. Hit ↓ Download Project to get a ready-to-run zip named after your site. Press Ctrl+C to stop — your session is saved and can be resumed with siteblaze open.

History is stored in ~/.config/siteblaze/history/ and auto-pruned to the 10 most recent sessions. Use siteblaze open --delete to remove entries manually.

Flags

| Flag | Description | |---|---| | --preview | Open a live browser editor — tweak theme, colors, sections, then download | | -m, --model <id> | Force a specific OpenRouter model | | -o, --output <path> | Scaffold directly into this path (the path IS the destination — --output ./my-app creates ./my-app/, not ./my-app/<slug>/) | | -t, --type <type> | Site type: landing portfolio agency saas blog ecommerce event | | -f, --framework <fw> | vite (default) or next | | --theme <mode> | light dark midnight | | --ui <lib> | tailwind (default) or shadcn | | --image | Generate an AI hero image via Pollination AI (default: static placeholder) | | -y, --yes | Skip all prompts, use defaults | | --verbose | Show model details and generation source |

What gets generated

my-project/
├── src/
│   ├── Home.tsx          ← page layout — edit this to customise
│   ├── sections/         ← individual section components
│   └── theme.ts          ← colors, fonts, theme mode
├── public/
│   └── images/placeholder.png  ← swap with your own image
├── package.json
├── vite.config.ts
├── tailwind.config.js
└── README.md

Then:

cd my-project
npm install
npm run dev

Supported section types (22)

NAVBAR HERO FEATURES TESTIMONIALS PRICING CTA FAQ STATS TEAM NEWSLETTER LOGO_CLOUD SKILLS TIMELINE PORTFOLIO_GRID CONTACT_FORM GALLERY PRODUCT_GRID TRUST_BADGES COUNTDOWN SCHEDULE CASE_STUDY VIDEO_EMBED

Each section has 3 layout variants and is fully theme-reactive.

Model configuration

By default siteblaze races a curated list of free OpenRouter models — first valid response wins. The model list is fetched and cached automatically when you run siteblaze auth. To refresh it later:

# Re-fetch the model list from OpenRouter (fixes deprecated models)
siteblaze list-models --refresh

# Use specific models (comma-separated)
SITEBLAZE_MODELS=openai/gpt-4o,anthropic/claude-opus-4 siteblaze generate "..."

Precedence: SITEBLAZE_MODELS env → ~/.config/siteblaze/models.json → built-in defaults.

License

MIT