PR Custody

PRPR Custody

feat(onboarding): add mandatory source survey at end of all flows

@qdonohuechecks n/achecks…qd/mandatory-onboarding-source-question → main5 files · +161 −23updated 1w ago

GitHub

▸Description · 1 noise

Summary

Adds an unskippable "How did you hear about Composio?" step as the final step of every onboarding flow (developer, consumer, CLI)
Intercepts all terminal-step exits in context.tsx — no changes needed to existing step configs
Fires ONBOARDING_SOURCE_SURVEY_COMPLETED PostHog event with { source: value } on completion

Options

Value	Label	Description
`search`	Search engine	Google, Bing, etc.
`twitter-x`	Twitter / X	Organic post or ad
`linkedin`	LinkedIn	Organic post or ad
`friend-colleague`	Friend or colleague	Word of mouth
`community`	Online community	Reddit, Hacker News, Discord, Slack
`blog-newsletter`	Blog or newsletter	Article, tutorial, or newsletter
`podcast`	Podcast	Heard it on a show
`ai-assistant`	AI assistant	ChatGPT, Claude, Perplexity, etc.
`other`	Other	Something else

How it works

When any terminal step calls next() → null, navigate() intercepts before exit, computes and stores the intended exit URL + flow in localStorage (onboarding_survey_pending), then routes to /onboarding/source-survey. After the user picks a source, the survey step reads the stored URL and navigates there, firing OnboardingCompletedEvent with the correct original flow.

Test plan

Complete developer flow (explore path) → source survey appears → selecting an option navigates to /~/project/playground
Complete developer flow (level-up path through goals) → source survey appears → navigates to /~/project/getting-started
Complete consumer flow (choose-client step) → source survey appears → navigates to correct client URL
Complete CLI flow (cli-setup step) → source survey appears → navigates to /~/org/connect
Verify ONBOARDING_SOURCE_SURVEY_COMPLETED event fires in PostHog with source property
Verify step has no skip button and cannot be bypassed

🤖 Generated with Claude Code

▸ 1 bot/status comment hidden

@vercel[bot]3w ago

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
dashboard	Ready	Preview, Comment	Jun 4, 2026 7:49pm

loading diff…