@zen-agentchecks…zen/fix-onboarding-loop-u8jm0r → main8 files · +106 −9updated 2mo agoFixes the infinite onboarding loop where users could never reach the actual dashboard after completing onboarding. Both consumer and developer flows were affected.
Root cause — Consumer flow (the reported bug):
/~/org/connect/clients/claude-codehasConsumerProject(userId) → false (no consumer project was ever provisioned — it only gets created by consumerMiddleware when a consumer tRPC procedure runs, but the layout gate prevents the page from loading)/onboarding/consumer-role → infinite loopdefaultOrgMiddleware may fail for new users (read replica lag after signup), so the onboardingConsumerProcedure throws UNAUTHORIZEDRoot cause — Developer flow (also broken):
onboardingComplete was never persisted — the hasDeveloperOnboardingComplete() checker existed but no mutation to set the flag was ever createdChanges:
Consumer flow fix:
provisionConsumerProject tRPC mutation using onboardingConsumerProcedure — triggers the consumerMiddleware which auto-provisions via ensureConsumerProjectnavigate() when consumer flow exits (alongside completeOnboarding)onboardingComplete metadata flag as a fallback — if provisioning failed during exit, the page's tRPC calls will auto-provision via consumerMiddlewareDeveloper flow fix:
completeOnboarding tRPC mutation sets onboardingComplete: true via Apollo admin endpointnavigate() when any flow exits (awaited before redirect)hasConsumerProject and hasDeveloperOnboardingComplete — passes if either is true/~/project/ and /~/org/ smart redirect fallbacks route onboarding-complete users to /create-workspace instead of back into the looppnpm lint) and typecheck (pnpm typecheck) — no new errors (all failures are pre-existing)/ → /onboarding/platform → consumer-role → consumer-choose-client → consumer-connect-apps → provisionConsumerProject + completeOnboarding mutations → redirect to /~/org/connect/clients/claude-code → Connect layout passes (hasConsumerProject OR onboardingComplete)/ → /onboarding/platform → developer-role → developer-path → completeOnboarding mutation → redirect to /~/project/playground → root page passes (hasDeveloperOnboarding)provisionConsumerProject follows the onboardingConsumerProcedure middleware chain (defaultOrgMiddleware → consumerMiddleware → ensureConsumerProject)completeOnboarding follows the same pattern as existing savePlatformMetadata and saveSeenFlow mutationsTriggered by: palash@composio.dev | Source: slack Session: https://zen-api-production-4c98.up.railway.app/dashboard/#/chat/zen-f2d81e62b6ed
Re: Cursor Bugbot review on floating promises in navigate():
Fixed in 40f9a3ef — added a navigatingRef guard to prevent duplicate calls while the async completion mutations are in flight. The ref is checked at the top of navigate() and set before any work starts, so duplicate clicks from onSelect/onSkip are silently ignored.
| Check | Status |
|---|---|
| Codex review | LGTM (2 iterations, 0 issues) |
| CI | All checks passed (3 commits) |
| Build checks | Pre-existing failures only (launchdarkly types, OpenAPI admin endpoints) |
| PR comments | Bugbot floating-promise issue fixed in 40f9a3ef |
| Browser test | Dashboard dev server blocked by pre-existing dependency issue (launchdarkly-react-client-sdk missing, @composio/lib unavailable on npm). Changes are server-side redirect logic with no visual UI changes. |
87d164dd — Developer flow fix: completeOnboarding mutation + root page/route handler gatesba5c183b — Consumer flow fix: provisionConsumerProject mutation + connect layout gate fallback40f9a3ef — Guard against duplicate navigate calls (Bugbot review fix)The latest updates on your projects. Learn more about Vercel for GitHub.
| Project | Deployment | Actions | Updated (UTC) |
|---|---|---|---|
| dashboard |  Ready | Preview, Comment | Apr 12, 2026 7:40pm |