Projects

Each project is an isolated backend with its own database, auth, and API endpoints. Managed entirely from the CLI.

Create a project

terminal

based new <name>

# Example
based new my-app
# → URL: https://my-app.based.yourdomain.com
# → Anon Key: xxxx

Names must be kebab-case, lowercase, max 63 characters. Each project gets its own SQLite database, JWT secret, and anon key.

List projects

terminal

based list

#   Name                  URL                                         Status
#   ----------------------------------------------------------------------
#   my-app        https://my-app.based...              active
#   my-blog               https://my-blog.based...                    active

Get env vars

terminal

based env my-app
# NEXT_PUBLIC_BASED_URL=https://my-app.based.yourdomain.com
# NEXT_PUBLIC_BASED_ANON_KEY=xxxx

Delete a project

terminal

# With confirmation prompt
based delete my-app

# Skip confirmation
based delete my-app --force

This permanently deletes the database and all data. There is no undo.