BlueForge Docs

forge project create

Create a new BlueForge platform project via CLI.

Command

forge project create <name> [--plan <plan>] [--region <region>]

Arguments

NameTypeRequiredNotes
name
stringyesDisplay name; slug auto-derived

Flags

FlagTypeDefaultNotes
--plan
enum
free
free
|
starter
|
pro
|
team
--region
enum
eu
eu
|
sea
|
us

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 codeMeaning
0Created successfully
1Invalid input (name, plan value)
2Auth failure (no key, invalid key)
3Conflict (name already exists)

Pitfalls

  • Async creation — the command returns immediately with
    status: provisioning
    . Use
    forge project list
    or
    forge project info <id>
    to poll until
    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}