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

🎁 Evidencia visual = reward extra

  • Si tu PR incluye video demo o capturas de pantalla mostrando la funcionalidad pedida funcionando end-to-end, va a ser considerado para rewards de GrantFox en esta issue. No es obligatorio, pero suma mucho para la evaluación.

Metadata

Metadata

Assignees

No one assigned

    Labels

    GrantFox OSSPart of the GrantFox OSS campaignMaybe RewardedMay be eligible for GrantFox rewardThird CampaignCampaign: Third CampaignenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions