Scaffold a project

The template is distributed as a licence-gated CLI scaffolder. Instead of cloning a repo, you run one command; it verifies your licence, asks what to include, and writes a clean project with only the code for the features you picked — no dead imports, no unused dependencies.

Run the scaffolder


npx create-stackblaze-app my-saas-app

my-saas-app is the output directory (and is optional — you’ll be prompted for it if omitted).

The prompts

Licence key


Licence key  sb-xxxx-xxxx-xxxx-xxxx

Paste your key. It’s validated against the licence server before anything is written. If the server is unreachable, a short offline grace window lets verified keys through.

Project name

The output directory name. Letters, digits, ., -, and _; must start alphanumeric.

AI provider

Pick the provider that backs the chat layer. One choice from:

openai, anthropic, google, xai, groq, mistral, cohere, togetherai, fireworks, deepinfra, deepseek, cerebras, perplexity, azure, bedrock, vertex, baseten, openrouter, ollama.

Only the SDK for the provider you choose is added to package.json. You can switch providers later by changing AI_PROVIDER in .env.local (install the matching @ai-sdk/* package if you switch to a different one).

Features to include

A multi-select. Pick any combination:

Feature	Notes
Multi-tenant workspaces	Org-scoped data model
Admin portal	Platform-owner portal — implies multi-tenancy
AI chat interface	The streaming chat UI
Agentic tool calling	Tool registry + web search — implies AI chat
Rate limiting (Upstash Redis)	Per-plan request limits
Transactional email (Resend)	Otherwise emails print to the console
LangFuse observability	AI tracing — implies AI chat

Implied features resolve automatically. Pick Admin portal and you get multi-tenancy too; pick Agentic tool calling or LangFuse and you get AI chat. You don’t need to tick the dependencies yourself.

Run npm install? / Initialise git?

Two yes/no confirmations. Both default to yes. If you decline install, you’ll run npm install yourself in the next step.

What gets generated

The scaffolder copies the template, then strips everything you didn’t select:

Feature directories you skipped are omitted entirely (e.g. app/(admin)/** only ships if you chose the admin portal).
Conditional blocks inside shared files are removed.
package.json only lists the dependencies your selection needs — your chosen AI SDK, stripe, @upstash/*, resend, web-search SDKs, and so on.
.env.example only contains the keys your features use.

The result is a self-contained project you own. There’s no runtime call back to StackBlaze.

Next steps it prints

After generating, the CLI prints something like:


  → cd my-saas-app
  → cp .env.example .env.local   (fill in your keys)
  → npm run db:push
  → npm run dev

Follow those in Local setup →.