🚀 Getting Started

FlowFast Documentation

Learn how to build full-stack applications 10x faster with our AI-powered development platform. From installation to production deployment.

Authentication Required Before Using CLI
You need valid credentials to use the FlowFast CLI

Step 1: Get Your Credentials

  • Subscribe to any pricing plan
  • Check your email for welcome message
  • Look for email from Sasha from FlowFast
  • Save your email and secure access code

Step 2: Login to CLI

flowfast login
  • Run flowfast login
  • Enter your email address
  • Enter your secure access code
  • You'll be automatically logged in
What You'll Receive in Your Welcome Email
Email Address

The same email you used for purchase

Secure Access Code

Format: FL0W-4CC3SS-XXXXXXXX

Prerequisites

Set up your environment with the required Node.js version before installing FlowFast

1

Install nvm (Node Version Manager)

First, install nvm to manage Node.js versions

Windows (Chocolatey):

choco install nvm

Linux (apt):

sudo apt update && sudo apt install nvm
💡 Note: After installing nvm, you may need to restart your terminal or run source ~/.bashrc (Linux) or reopen your terminal (Windows)
2

Install Node.js v22.11.0

Install and use the required Node.js version

nvm install 22.11.0 && nvm use 22.11.0
🔧 This installs Node.js v22.11.0 and sets it as the active version
3

Verify Installation

Confirm Node.js version is correct

node --version
Expected output: v22.11.0
Ready for FlowFast Installation
Your environment is now set up with Node.js v22.11.0. Continue to the installation steps below.
Important: Managed Folders & File Safety
Understand how FlowFast manages files to avoid losing your work

🚨 Auto-Pilot Managed Folders

These folders are completely managed by Auto-Pilot and will be emptied on each code generation:

/lib/trpc/managed
/app/managed

Never add your custom code to these folders within your project - they will be deleted during code generation!

⚠️ Compose Command Overwrites

flowfast compose command overwrites files in your project root. Always backup custom changes before running compose.

✅ Safe Development Practice
  • • Keep custom code outside managed folders
  • • Use version control (git) to track changes
  • • Backup custom modifications before compose
  • • Use Node.js v22.11.0 for compatibility
  • • Get your access code from pricing page first

5-Minute Quick Start

Get from zero to production-ready application in just a few commands

1

Install CLI

Install FlowFast globally on your machine

npm i -g @flowfast/cli
2

Create Account & Get Credentials

Subscribe to a plan and receive your login credentials via email

Warning: 🔐 Required before you can use the CLI
📧 You'll receive an email with your secure access code after purchasing any plan
3

Login to CLI

Authenticate with your email and access code

flowfast login
Enter the email and access code from your welcome email
4

Initialize Project

Create a new project or use existing folder

flowfast init
💡 If the app name exists on our servers, we'll load your saved state automatically
5

Compose Modules

Merge boilerplate code into your project

flowfast compose
Warning: ⚠️ Overwrites files - backup custom changes first
6

Install Dependencies

Get your project ready for development

npm install
7

Start Building

Launch the interactive FlowFast interface

flowfast
🎯 This launches the interactive CLI where the magic happens!

Core Features Explained

Understand how each feature accelerates your development workflow

👽
Just Ask Yoda
Describe your data model in plain English and watch as AI designs it for you
  • Natural language to PostgreSQL schemas
  • Iterative refinement through conversation
  • Instant schema generation with proper constraints
  • PostgreSQL-optimized data types and relationships
🔺
Visualize & Validate
See your data model as interactive ER diagrams to validate your design
  • Real-time ERD visualization
  • Relationship mapping
  • Design validation
  • Export capabilities
🤖
Auto-Pilot Developer
Automatically generate code based on your subscription tier
  • Starter: ORM schema generation
  • Standard: Push schema + seed data
  • Pro: tRPC APIs, Zod and Next.js app
  • ⚠️ Manages /lib/trpc/managed and /app/managed folders
🛠️
Undo/Redo Safety Net
Recover from AI misinterpretations with full version control
  • Word-style undo/redo
  • Recover from hallucinations
  • Iterative refinement
  • State management

CLI Command Reference

Complete reference of all FlowFast CLI commands

flowfast login
Authentication Required

You must have a valid subscription and access code to use this command. Get your credentials from the pricing page.

Authenticate with your FlowFast account using the email and access code from your welcome email.

$ flowfast login
Prompts for email address
Prompts for secure access code
Stores authentication token locally
Required before using other CLI commands
flowfast init [appName]

Initialize a new FlowFast project. Creates the project structure and configuration files.

Smart App Detection

If the app name already exists on our servers, we'll automatically load your saved state while setting up the local project structure. You get a fresh local setup that continues right where you left off.

$ flowfast init my-saas-app
$ flowfast init (prompts for app name)
flowfast compose
Important: File Overwrite Warning

This command overwrites files in your project root. Always backup custom changes before running compose.

Merge module code into your project root. Handles file conflicts intelligently:

  • • JSON files are merged
  • • Environment files are concatenated
  • • Other files are copied/overwritten
$ flowfast compose
flowfast
Managed Folders Warning

Auto-Pilot empties these folders from your project root during every code generation:

/lib/trpc/managed
/app/managed

Launch the interactive FlowFast interface. This is where you'll do most of your work.

$ flowfast
Just Ask Yoda- Design data models through conversation
Visualize- View and validate ER diagrams
Auto-Pilot- Generate code based on your plan
Undo/Redo- Recover from AI misinterpretations

Team Management Commands

Manage your team members and control access to your FlowFast workspace

flowfast subscribers
View Team Members

List all team members in your subscription with their roles and status.

Display all current team members, their roles, and subscription status. Only available to subscription owners and admins.

$ flowfast subscribers
Shows all team members with email addresses
Displays role (Owner, Admin, Member)
Shows invitation status and join date
Only available to owners and admins
Helps manage seat allocation and permissions

Example Output:

✓ Current Team Members (3/5 seats used):
• you@company.com (Owner) - Active
• admin@company.com (Admin) - Active
• dev@company.com (Member) - Active
ℹ 2 seats available
flowfast invite [email]
Invite Team Members

Assign a seat to a team member. They'll receive an email with their access code.

Invite a new team member to your subscription. This uses one of your available seats and sends them a welcome email with their credentials.

$ flowfast invite teammate@company.com
Requires available seats in your subscription
Sends welcome email to the invited user
New user gets their own access code
Only subscription owners and admins can invite
flowfast revoke [email]
Remove Team Member

Immediately revokes access and frees up the seat for another team member.

Remove a team member from your subscription. This frees up their seat so you can invite someone else.

$ flowfast revoke former-teammate@company.com
Immediately revokes their access
Frees up the seat for new invitations
Cannot revoke your own access
Only subscription owners and admins can revoke
flowfast promote [email]
Grant Admin Privileges

Give a team member admin access to manage users and settings.

Promote a team member to admin. Admins can invite/revoke users and manage team settings.

$ flowfast promote senior-dev@company.com
Grants ability to invite/revoke team members
Admins can manage team settings
Cannot demote the subscription owner
Only subscription owners can promote users
flowfast demote [email]
Remove Admin Privileges

Remove admin access from a team member while keeping them in the subscription.

Demote an admin back to regular user. They keep their seat but lose the ability to manage team members.

$ flowfast demote former-admin@company.com
Removes admin privileges but keeps access
User can still use FlowFast normally
Cannot demote the subscription owner
Only subscription owners can demote users

Ready to Start Building?

You now have everything you need to start building production applications with FlowFast.