Skip to content

create-startups

npm create startups: its inputs, flags, templates, and the records and files it creates.

npm create startups creates a Startup in api.sb and a local directory that defines it as code.

Usage

Terminal
npm create startups "Acme AI"
pnpm create startups acme.com
yarn create startups
bun create startups
npx create-startups --json '{"name":"Acme AI","idea":"Patent drafts for solo inventors"}'

Inputs

InputExampleCreates
A name"Acme AI"One Startup on a free subdomain
A domainacme.comOne Startup on that domain
Several names"Acme AI" "Beta Labs"One Startup each
JSON--json '{"ideas":[…]}'One Startup per idea
NothingNone.Prompts for an idea, then suggests names

Flags

FlagValueDescription
--template<template>The Template the Startup extends. Defaults to the root Template.
--json<object>The Startup as JSON: name, domain, idea, or a list of ideas.
--dir<path>The project directory. Defaults to the Startup name in kebab case.
--envtest | liveWhere the Startup is created. Defaults to test.
--no-installNone.Writes the project without installing packages.
--dry-runNone.Prints what it creates and writes nothing.
--outputjson | textThe output format. Agent mode defaults to json.
--yesNone.Accepts every default without prompting.

Templates

Every new Startup extends the root Template unless --template names another.

Outputs

In api.sb: the Idea, the Startup in Test, its first domain, and one agent per Role its Template staffs. On disk: a project that defines the Startup as code.

  • acme-ai/
  • startup.tsthe Startup, as code
  • startups.lockthe Startup Template Version it pins
  • AGENTS.mdhow any coding agent works this Startup
  • .mcp.jsonthe MCP server, scoped to the Startup
  • package.json

It prints the next command to run:

Terminal
cd acme-ai
npx startup-builder show /