Skip to content

feat(desktop): add first-run onboarding tab - #95869

Draft
adamleithp wants to merge 1 commit into
masterfrom
posthog/desktop-first-run-onboarding
Draft

feat(desktop): add first-run onboarding tab#95869
adamleithp wants to merge 1 commit into
masterfrom
posthog/desktop-first-run-onboarding

Conversation

@adamleithp

Copy link
Copy Markdown
Contributor

Problem

New PostHog Desktop users have no persistent place to learn the main concepts after setup.

The setup flow ends on an active session, so onboarding must not replace that work.

Changes

  • First runs now add an inactive Onboarding tab after the active session.
  • The page explains Spaces, Multiplayer, Self-driving, Canvases, Agents, and Tasks.
  • Each concept link opens a new app tab, so the onboarding page stays open.
  • The Onboarding tab uses a pulsing sparkle icon and stops the motion when reduced motion is active.
  • The page hides Self-driving when the destination is unavailable.
  • The app records onboarding page views and destination selections.
  • The app uses the existing provisioning signal and stores one insertion marker per project identity.

Before: PostHog Desktop had no onboarding tab or landing page.

After:

onboarding-landing

How did you test this code?

  • Scoped Vitest tests protect background activation, one-time insertion, destination mappings, and availability gating.
  • pnpm typecheck checked the complete Desktop workspace.
  • The host boundary check passed.
  • The Storybook build passed and produced the screenshot above.
  • hogli ci:preflight --fix ran Desktop Biome on every changed file.
  • The task shell could not run pnpm lint because it invoked ESLint without a configuration file.
  • The Electron first-account flow was not tested manually.

👉 Stay up-to-date with PostHog coding conventions for a smoother review.

Automatic notifications

  • Publish to changelog?

Docs update

The browser tabs guide now documents the first-run tab and inactive tab creation.

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

  • Pi used Explore subagents and Playwright.
  • The task applied /posthog-desktop, /writing-ui-components, /writing-user-facing-copy, /writing-tests, and /writing-code-comments.
  • The task also applied /instrument-product-analytics, /running-ci-preflight, /writing-pr-descriptions, /subagent-orchestration, and /writing-simplified-technical-english.
  • An open pull request search found no matching implementation.

Created with PostHog Desktop

Add an inactive onboarding tab after first-run setup.
Add a concept landing page with new-tab links and usage events.

Generated-By: PostHog Desktop
Task-Id: 30031954-7d65-48db-85ea-8a6a7dbf380d
@adamleithp adamleithp self-assigned this Sep 7, 2026
@trunk-io

trunk-io Bot commented Sep 7, 2026

Copy link
Copy Markdown

Merging to master in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

After your PR is submitted to the merge queue, this comment will be automatically updated with its status. If the PR fails, failure details will also be posted here

@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

React Doctor found no issues in the changed files. 🎉

Reviewed by React Doctor for commit f5e5bed.

@github-actions github-actions Bot added the feature/desktop Feature Tag: Desktop label Sep 7, 2026
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

🤖 CI report

Trunk lane — non-backend lane

This PR is assigned to the non-backend lane. It does not run backend Python tests and may merge in parallel with PRs in other lanes.

@hosthog

hosthog Bot commented Sep 7, 2026

Copy link
Copy Markdown

HostHog preview — posthog-desktop-web

Latest build (f5e5bed): https://93e875b4612747049f30192785658a67.hosthog.dev

Employee-gated; every push gets a fresh URL whose content never changes. All previews stop serving when the PR closes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature/desktop Feature Tag: Desktop

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant