Skip to content

Bootstrap CLI: interactive setup wizard for new Open-Stellar deployments #309

Description

@leocagli

Context

PR#307 (pending) adds an npx open-stellar bootstrap CLI command. This companion issue specifies the interactive wizard flow for first-time setup.

What to implement

Wizard steps (prompts via readline or @inquirer/prompts)

  1. Project name — used as the NEXT_PUBLIC_APP_NAME env var
  2. Stellar networktestnet or mainnet (sets STELLAR_NETWORK)
  3. Database URL — validate format; set DATABASE_URL
  4. Admin wallet address — must be a valid G... Stellar public key
  5. Confirm — show a summary and ask to proceed

Output

  • Write a .env.local file with all values
  • Print a success message with next steps (npm run dev)

Validation

  • Step 4: reject non-Stellar addresses (not starting with G, not 56 chars)
  • Step 3: warn (don't fail) if URL doesn't look like postgres://...

Acceptance criteria

  • Running npx open-stellar bootstrap launches the wizard
  • Invalid Stellar address at step 4 → re-prompt
  • .env.local written with all 4 values
  • --yes flag skips confirmations with defaults (for CI use)
  • Unit test: wizard with all valid inputs → correct .env content

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions