Skip to main content

Overview

Projects live inside organizations and own all resources — tables, functions, deployments, messaging, flags, etc. Every resource belongs to exactly one project.

Commands

List Projects

Lists all projects across the entire instance.
applad projects list
Lists all projects belonging to a specific org.
applad projects list --org <org-id>
Flags:
  • --org - Filter projects by organization ID

Create Project

Creates a new project inside an org. Scaffolds the project directory at orgs/<org>/projects/<name>/ with a project.yaml, empty subdirectories for each resource type, and a generated .env.example.
applad projects create \
  --name "Mobile App" \
  --org "acme-corp"
Flags:
  • --name - Name of the project to create
  • --org - Organization ID to create the project in

Delete Project

Permanently deletes a project and all its config files. Does not automatically delete runtime data — use applad db reset (dev only) or coordinate a manual data cleanup. Will prompt for confirmation.
applad projects delete <project-id>

Switch Project

Sets the active project context for all subsequent commands. Most commands that are project-scoped default to whichever project you’ve switched to here, saving you from having to pass --project on every command.
applad projects switch <project-id>

Show Project Info

Shows details about the currently active project — its ID, org, configured environments, infrastructure targets, and which features are enabled.
applad projects info

Clone Project

Creates a new project by copying the config structure of an existing project. Copies all yaml files (tables, functions, deployments, flags, etc.) but does not copy runtime data, secrets, or infrastructure state. Useful for creating a staging environment that mirrors production’s structure.
applad projects clone <project-id> \
  --name "Mobile App Staging"
Flags:
  • --name - Name for the cloned project

Examples

Create a new project

applad projects create \
  --name "Mobile App" \
  --org "acme-corp"

List all projects in an organization

applad projects list --org acme-corp

Switch to a project

applad projects switch mobile-app

View current project details

applad projects info

Clone a project for staging

applad projects clone mobile-app \
  --name "Mobile App Staging"

Delete a project

applad projects delete old-project

Build docs developers (and LLMs) love