fuel create:appfuel create:app
Scaffold a new app from the Fuel monorepo template with optional ECS provisioning.
Usage
fuel create:app <name> [options]Description
Creates a new full-stack project by copying the Fuel monorepo template, removing unselected modules, installing dependencies, building the project, and generating database migrations. Pass --config to also provision the complete AWS ECS infrastructure (ECR, ECS/Fargate, RDS, ALB, VPC, IAM OIDC, Secrets Manager) and push the code to a new GitHub repository.
Options
| Flag | Description | Default |
|---|---|---|
-m, --modules <list> | Comma-separated list of modules to include (e.g. billing,documents). | — |
-a, --all-modules | Include all available modules. | — |
-o, --output <path> | Output directory for the new project. | ./<name> |
-s, --source <path> | Path to a local monorepo root to use as the template source. | — |
--dry-run | Preview the scaffolding operation without writing any files. | — |
--skip-install | Skip yarn install. Also implicitly skips migration generation, since migrations require a build. | — |
--skip-build | Skip yarn build. Also implicitly skips migration generation, since migrations require a build. | — |
--skip-git | Skip git init and initial commit. | — |
--skip-migration-generation | Skip database migration generation. | — |
--keep-migrations | Keep existing migrations from the template instead of regenerating. | — |
-c, --config <path> | Path to fuel.yml. When provided, triggers full AWS ECS infrastructure provisioning. | — |
--target-branch <branch> | Only push to this branch (useful for CI pipelines). | — |
--force-push | Force push code to the target repository. | — |
--destroy-on-failure | Automatically destroy provisioned AWS resources if OpenTofu fails. | — |
--skip-branch-protection | Skip configuring GitHub branch protection rules. | — |
--github-token <token> | GitHub personal access token. | — |
--github-username <user> | GitHub username. | — |
--github-organization <org> | GitHub organization where the repo will be created. | — |
--aws-access-key-id <key> | AWS Access Key ID. | — |
--aws-secret-access-key <secret> | AWS Secret Access Key. | — |
--aws-region <region> | AWS region for infrastructure provisioning. | us-east-1 |
Examples
Basic scaffold (no modules, no cloud)
fuel create:app my-appScaffold with specific modules
fuel create:app my-app --modules billing,documentsScaffold with all available modules
fuel create:app my-app --all-modulesPreview without writing files
fuel create:app my-app --dry-runScaffold + full ECS infrastructure provisioning
fuel create:app my-app --config fuel.ymlLive Demo
Simulated terminal output for fuel create:app. Press replay to restart.
fuel create:app
$