Scaffold Only
Scenario

Scaffold Only

Create a new full-stack project locally — without provisioning any cloud infrastructure. Ideal for development, experimentation, or teams that manage their own deployment.

Prerequisites

  • Node.js >= 22 installed
  • Yarn >= 1.22 installed
  • Docker Desktop running (for database migrations)
  • FUEL CLI installed: npm install -g @swovohq/fuel
1

Check available modules

Before scaffolding, see which optional feature modules you can include in your new app.

fuel list:modules
$
2

Scaffold the app

Run fuel create:app with the name of your project. Add --modules to include optional features.

fuel create:app my-app --modules billing
$

Notes

  • •Use --all-modules to include every available module.
  • •Use --dry-run to preview which files would be created without writing anything.
  • •Use --skip-install if you want to run yarn install yourself later.
3

Start development

Navigate into the new project and start the dev server.

cd my-app && yarn dev

Notes

  • •The API runs on http://localhost:3000
  • •The web app runs on http://localhost:3001
  • •Make sure Docker is running before starting — the API needs PostgreSQL.