forge project create
Create a new BlueForge platform project via CLI.
Command
forge project create <name> [--plan <plan>] [--region <region>]
Arguments
| Name | Type | Required | Notes |
|---|---|---|---|
| string | yes | Display name; slug auto-derived |
Flags
| Flag | Type | Default | Notes |
|---|---|---|---|
| enum | | | | | |
| enum | | | | |
Examples
Basic:
forge project create my-app --plan pro
# → Created project "my-app" (slug: my-app)
# → Status: provisioning
# → Connection string: postgresql://...
With region:
forge project create my-app --plan starter --region eu
Errors
| Exit code | Meaning |
|---|---|
| 0 | Created successfully |
| 1 | Invalid input (name, plan value) |
| 2 | Auth failure (no key, invalid key) |
| 3 | Conflict (name already exists) |
Pitfalls
- Async creation — the command returns immediately with
. Usestatus: provisioning
orforge project list
to poll untilforge project info <id>
.ready - Credentials printed to stdout — pipe to a secure store if capturing. They won't be shown again.
- Name collisions — slugs must be unique within the tenant. Use a distinctive name.
See also
{auto-injected}
Tested against
{auto-injected}