BlueForge Docs

forge init

Scaffold a blueforge.config.json for the current project.

Command

forge init [--name <n>] [--type <t>] [--port <p>] [--domain <d>] [--server <s>] [--yes] [--force]

Arguments

None.

Flags

FlagTypeDefaultNotes
--name
stringdirectoryApp name
--type
enumauto-detected
next
|
vite
|
express
|
hono
--port
int
3100
App port
--domain
string
<name>.blueforge.studio
Custom domain
--server
string
hetzner-prod-1
Target server
--yes
bool
false
Skip all prompts
--force
bool
false
Overwrite existing
blueforge.config.json

Examples

Auto-detect:

forge init
# → Detected type: next
# → Created blueforge.config.json

Full explicit:

forge init --name my-api --type hono --port 3000 --yes

Errors

Exit codeMeaning
0Config created successfully
1Failed to create config

Pitfalls

  • No overwrite — will NOT overwrite an existing
    blueforge.config.json
    without
    --force
    .
  • Type auto-detection — checks
    package.json
    dependencies (e.g.,
    next
    for Next.js,
    vite
    for Vite,
    express
    for Express,
    hono
    for Hono).
  • Interactive mode — without
    --yes
    , the CLI prompts for any missing values.

See also

{auto-injected}

Tested against

{auto-injected}