Skip to content

feat(code): Restore signals onboarding inside the Inbox view#2376

Merged
Twixes merged 14 commits into
mainfrom
posthog-code/restore-signals-onboarding-in-inbox
May 26, 2026
Merged

feat(code): Restore signals onboarding inside the Inbox view#2376
Twixes merged 14 commits into
mainfrom
posthog-code/restore-signals-onboarding-in-inbox

Conversation

@Twixes
Copy link
Copy Markdown
Member

@Twixes Twixes commented May 26, 2026

Problem

PR #2208 dropped the signals step from app onboarding to improve conversion, completely. Users with no GitHub or no signal sources just saw an emptyWelcomePane in the Inbox, no config, no onboarding.

Changes

Restoring InboxSetupPane mirroring the deleted SignalsStep design, that reuses SignalSourcesSettings.

Screenshot 2026-05-26 at 20 15 42@2x

(also makes the buttons non-red for @annikaschmid, and actually switched to @adamleithp's Quill)

I think the better onboarding flow is something like:

  1. Bento grid on autonomy/signals, explaining how all this works - much like the general PH Code onboarding
  2. Then connect GitHub (a bar above shows you "Next step: Configure sources")
  3. Then connect sources
  4. Then optionally set up notifications
  5. Plopped into inbox warming up state

– but a good splash screen will take a little bit of work, so preferring to just restore for now.

Publish to changelog?

no

PR #2208 dropped the signals step from app onboarding to improve conversion, but the setup UX it removed never landed anywhere else — users with no GitHub or no signal sources just saw a stripped-down WelcomePane that bounced them into a modal.

Replaces that empty state with an inline InboxSetupPane that mirrors the deleted SignalsStep (hero copy, detective hog tip, animated entrance) and embeds SignalSourcesSettings so users get GitHub connect, source toggles, PR auto-start threshold, and Slack notifications without leaving the Inbox. Warming-up state and the configuration dialog (still opened from the toolbar and auto-open effect) are unchanged.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 26, 2026

Reviews (1): Last reviewed commit: "feat(code): Restore signals onboarding i..." | Re-trigger Greptile

Twixes added 5 commits May 26, 2026 16:19
Previously the inline setup pane only appeared in the existing empty-state branch, so a user with discovered/suggested tasks (but no real signal reports and no sources configured) was pushed into the two-pane RecommendedSetupTasks view and never saw the onboarding.

Lifts the onboarding to a top-level branch ahead of two-pane and changes the condition to `!hasReports && !hasSignalSources`. Suggested tasks alone no longer skip a source-less user past setup. The GitHub-only-missing case now falls through to two-pane or warming-up, where the existing InboxSourcesDialog auto-open continues to prompt when totalCount > 0.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
…rding

The inline setup pane already is the configuration UI, so the toolbar shortcut that opens InboxSourcesDialog over the top of it was a duplicate, redundant path. Drop the onConfigureSources prop on the toolbar in the onboarding branch.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
…ltip

Three changes on top of the inline Inbox onboarding:

- Bigger subtext: bump the InboxSetupPane description from text-sm to text-base leading-relaxed so the explanation reads as a clear hero paragraph rather than fine print.
- Hide search bar in onboarding: add a hideSearch prop to SignalsToolbar and pass it in the onboarding render. The search row makes no sense before any reports exist.
- Sticky onboarding within a visit + revisit teaching tooltip: onboarding no longer flips off the instant a source is toggled on. An onboardingStickyRef latches true on first entry and unwinds naturally when InboxView unmounts on navigation away. A new persisted store (inboxOnboardingStore) tracks hasSeenOnboarding and hasDismissedConfigTooltip in localStorage. On the next inbox visit after onboarding, the Configure sources toolbar button shows a persistent Radix tooltip "All of your Inbox configuration is here" (side=bottom, align=end). Opening the InboxSourcesDialog by any path — manual click or the existing totalCount>0 auto-open — dismisses the tooltip permanently.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
The report counter, search, and bulk-actions row are all meaningless before any source is configured. Render only the InboxSetupPane inside a ScrollArea during onboarding. Drop the now-unused hideSearch prop on SignalsToolbar.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
@Twixes Twixes force-pushed the posthog-code/restore-signals-onboarding-in-inbox branch from 0be8c4b to 963a87c Compare May 26, 2026 15:52
@Twixes Twixes requested a review from a team May 26, 2026 15:55
Twixes added 8 commits May 26, 2026 18:31
The TextField→TextArea + Cmd/Ctrl+Enter change in ReportDetailPane was
unrelated to the Inbox onboarding restoration and got bundled into an
earlier commit on this branch by mistake. Reverting it back to main.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
Drop the sticky-within-visit + persistent tooltip behavior. The full-page
InboxSetupPane shows only while !hasReports && !hasSignalSources; the
instant that condition turns false (user enables their first source),
the InboxSourcesDialog modal pops automatically so the user can keep
configuring with the inbox visible underneath.

Removes the now-unused inboxOnboardingStore and the configSourcesTooltipOpen
plumbing on SignalsToolbar.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
…scape hatch

Once a user enters the Inbox onboarding view in a session, keep them
there until they either navigate away (natural unmount reset) or click
the new "Proceed to Inbox" button in the bottom-right of the setup
pane. Replaces the auto-pop-the-sources-dialog behavior.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
…ate on source

The escape-hatch button now lives at the bottom of the InboxSetupPane
flex column (right-aligned) instead of an absolute-positioned overlay,
and it's disabled until at least one signal source is enabled — with
a "Disabled because Enable at least one source first" tooltip via the
shared Button's disabledReason mechanism.

Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
Generated-By: PostHog Code
Task-Id: 3f6eaf93-f574-44d9-aa91-bc4a7b8a68b9
@Twixes Twixes merged commit 2a2b187 into main May 26, 2026
15 checks passed
@Twixes Twixes deleted the posthog-code/restore-signals-onboarding-in-inbox branch May 26, 2026 20:00
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.

2 participants