All Posts
February 11, 20260.1.14Jugg.ai

v0.1.14 — Onboarding Wizard for New Users

Release v0.1.14: Onboarding Wizard for New Users

February 11, 2026

What changed

  • Onboarding wizard: New users now see a 4-step guided setup — Connect GitHub, Create Project, Run Pipeline, and Completion — instead of an empty dashboard.
  • Smart step detection: The backend checks actual state (GitHub token, projects, pipeline runs) so partially onboarded users resume from the correct step.
  • Onboarding gate: A new client component conditionally renders the wizard or the normal dashboard based on onboarding status.
  • New tRPC router: onboarding.getStatus query returns current onboarding progress with 30s stale-time caching.
  • Dashboard refactor: Extracted dashboard content into a standalone DashboardContent async server component, wrapped with Suspense and skeleton loading states.

Why it matters

New users previously landed on an empty dashboard with no guidance. This wizard walks them through the three actions needed to get value from the platform, which should directly improve activation rates.

Technical notes

  • No database schema changes — onboarding status is derived from existing users, projects, and pipeline_runs tables.
  • 6 files changed, +897 additions, -198 deletions (most deletions are the dashboard extraction refactor).
  • The "Run Pipeline" step includes a skip option for users who want to explore first.

Release Notes

Successfully merged PR #50 and published release v0.1.14.

What was released:

  • Interactive onboarding wizard that guides new users through their first setup (Connect GitHub → Create Project → Run Pipeline → Completion)
  • Smart step detection that resumes users at the correct onboarding step based on actual backend state
  • Onboarding gate component that conditionally shows the wizard or normal dashboard
  • New tRPC onboarding router with getStatus query
  • Dashboard refactored to extract content into a separate async server component

Details: