v0.2.1-alpha

Getting Started

FUEL CLI (@swovohq/fuel) is a command-line tool that scaffolds production-ready full-stack apps and provisions complete AWS ECS infrastructure — in a single command.

Scaffold Apps

Create a full-stack Next.js + NestJS monorepo with one command.

Feature Modules

Include billing, documents, groups, and identity providers out of the box.

AWS ECS Deploy

Provision ECR, ECS/Fargate, RDS, ALB, VPC, and IAM OIDC automatically.

CI/CD Ready

GitHub Actions workflows and branch protection configured automatically.

Requirements

Node.js ≥ 24
Yarn ≥ 1.22
Docker Desktop (for database migrations)
OpenTofu ≥ 1.8 — only required for AWS infrastructure provisioning

Installation

Install the FUEL CLI globally using your preferred package manager:

$ npm install -g @swovohq/fuel

Verify Installation

fuel --version

Quick Start

Scaffold a new project in under a minute:

fuel create:app my-app
cd my-app
yarn dev

To scaffold with optional modules (billing, documents, etc.):

fuel create:app my-app --modules billing,documents

Next Steps

fuel create:app

All options for scaffolding apps.

Scaffold Only

Step-by-step: create a local project.

Full ECS Deploy

Scaffold + provision AWS in one go.