Skip to content

feat(onboarding): add interactive walkthrough command#59

Merged
hbrombeer merged 1 commit into
mainfrom
feat/onboarding-command
Jun 8, 2026
Merged

feat(onboarding): add interactive walkthrough command#59
hbrombeer merged 1 commit into
mainfrom
feat/onboarding-command

Conversation

@hbrombeer

Copy link
Copy Markdown
Member

What

grounds onboarding (aliases: onboard, quickstart) — a guided, explain-then-do walkthrough that takes a new developer from zero to a running app in five steps:

Login → Workspace (Bundle) → App anlegen (init) → push → spielen

Each step first explains the concept (German copy), then runs the real command after a Ja/Überspringen confirm. Skipping is always allowed; re-runnable any time.

How

  • Reuses the existing subcommands (login / init / cluster up --bundle / push) via cobra Execute() — no duplicated logic.
  • Bundle as the default workspace (per request): the Workspace step resolves the latest released bundle ref (ListBundleReleasesIsLatest, falls back to main) and provisions it. A partial/failed bundle is surfaced and offers "continue anyway" rather than dead-ending.
  • Built on huh (already a dependency, previously unused); bails cleanly with a clear message when stdin is not a TTY.

Files: cmd/grounds/commands/onboarding/{onboarding.go,onboarding_test.go} + registration in main.go.

Verification

  • go build ./... + go vet clean; package test green (metadata + non-TTY guard).
  • grounds --help lists it; grounds onboarding --help renders; non-TTY input bails cleanly.
  • ⚠️ The interactive flow itself was not run (no TTY in the build env) — needs a live grounds onboarding smoke test.

Notes / possible follow-ups

  • Onboarding reliability depends on the Bundle pipeline's stability (it hard-defaults to a bundle).
  • First-run nudge (suggest grounds onboarding after first login / empty workspace) — not included here.

🤖 Generated with Claude Code

`grounds onboarding` (aliases: onboard, quickstart) — a guided,
explain-then-do walkthrough that takes a new developer from zero to a
running app in five steps: Login → Workspace (Bundle) → init → push →
play. Each step explains the concept, then runs the real command after a
Ja/Überspringen confirm.

Reuses the existing subcommands (login/init/cluster/push) via cobra
Execute() — no duplicated logic. The Workspace step provisions a Bundle
by default (resolves the latest released bundle ref via
ListBundleReleases, falls back to main). Built on huh (already a dep);
bails cleanly when stdin is not a TTY.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@hbrombeer hbrombeer merged commit 07b9a6c into main Jun 8, 2026
5 checks passed
@hbrombeer hbrombeer deleted the feat/onboarding-command branch June 8, 2026 05:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant