Skip to content

Create a project

  1. Copy or initialize the Starter with the bootstrap workflow.
  2. Run the local /setup workspace and enter the product identity, platforms, design profile, pages, SaaS modules, optional capabilities, providers, and two environment identities.
  3. Review the generated starter.blueprint.json. This file records intent; it is not a deployment action.
  4. Let the controller read the project context and materialize only selected packs.
  5. Provision a new empty database from that final selection. Do not carry Starter-era legacy migration or backfill logic into initialization.
  6. Run the repository verification gates before asking for a Development release.
  • AGENTS.md — operating, safety, documentation, and release rules.
  • PROJECT.md — product purpose and current state.
  • starter.blueprint.json — selected product shape.
  • catalog/catalog.json — available Design, Page, SaaS, and Capability packs.
  • design/catalog.json — selected visual profile and adapter readiness.
  • pages/catalog.json — route ownership, renderer, selection, and acceptance rules.
  • the current Change Spec and affected features/*/MODULE.md files.

A new Starter project begins from an empty PostgreSQL database and applies the current SQL baseline. Existing-product backfills or compatibility migrations do not belong in the Starter baseline; a product that already owns data must design those separately.

A page render or HTTP 200 is not enough. Completion requires the selected behavior, typechecks and builds, focused contract tests, documentation synchronization, bundle or performance budgets, and the relevant release dry run.