Skip to content

feat: Onboarding Pill#2440

Draft
camielvs wants to merge 1 commit into
06-17-feat_onboarding_checklistfrom
06-18-feat_onboarding_pill
Draft

feat: Onboarding Pill#2440
camielvs wants to merge 1 commit into
06-17-feat_onboarding_checklistfrom
06-18-feat_onboarding_pill

Conversation

@camielvs

@camielvs camielvs commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

Description

Second PR in the onboarding series (stacked on #2421). Makes onboarding progress visible from anywhere in the app, not just the Learning Hub.

  • Top-nav OnboardingNavPill — a compact Onboarding · X/Y pill that opens a popover with the full checklist. Mounted in both the v1 and v2 editor navs (hidden in tour mode). It hides itself once onboarding is complete or dismissed.
  • Provider readiness gating — adds isReady / isResolved so the pill (and other surfaces) only render once backend state has actually resolved, avoiding a flash of default/incorrect state on load.
  • Toasts — fire when a step is completed, when onboarding is fully complete, and an informational toast on dismiss ("you can resume from the Learning Hub").

No new routes or page-level changes — purely an always-available entry point plus the supporting provider state.

Stacked PR — base: Onboarding Checklist (#2421). Followed by the Onboarding Welcome Page (#2435).

Related Issue and Pull requests

Progresses https://github.com/Shopify/oasis-frontend/issues/622

Stacked on #2421 → followed by #2435

Type of Change

  • New feature

Checklist

  • I have tested this does not break current pipelines / runs functionality
  • I have tested the changes on staging

Screenshots (if applicable)

Test Instructions

  1. With onboarding in progress, confirm the Onboarding · X/Y pill appears in the top nav in both the v1 and v2 editors.
  2. Open the pill — the popover should show the same checklist as the Learning Hub.
  3. Complete a step — a success toast should appear and the pill count should update.
  4. Complete all steps — a completion toast should fire and the pill should disappear.
  5. Dismiss onboarding — an info toast should appear and the pill should hide.
  6. Confirm the pill does not flash on initial load before backend state resolves, and is hidden in tour mode.

Additional Comments

Gating is on isResolved (backend resolved + state loaded) rather than isReady, so the pill never renders against unresolved state.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown

🎩 Preview

A preview build has been created at: 06-18-feat_onboarding_pill/5ea2aaa

camielvs commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator Author

@camielvs camielvs mentioned this pull request Jun 19, 2026
3 tasks
@camielvs camielvs added the #gsd:50583 Learning Hub label Jun 19, 2026 — with Graphite App
@camielvs camielvs force-pushed the 06-17-feat_onboarding_checklist branch from a27cdb0 to 72eadf3 Compare June 19, 2026 02:09
@camielvs camielvs force-pushed the 06-18-feat_onboarding_pill branch 2 times, most recently from c38d713 to 5f5d39b Compare June 19, 2026 02:25
@camielvs camielvs force-pushed the 06-17-feat_onboarding_checklist branch from 72eadf3 to 14fbe7b Compare June 19, 2026 02:25
@camielvs camielvs force-pushed the 06-18-feat_onboarding_pill branch from 5f5d39b to c994062 Compare June 19, 2026 15:43
@camielvs camielvs force-pushed the 06-17-feat_onboarding_checklist branch from 14fbe7b to a39fbd9 Compare June 19, 2026 15:43
@camielvs camielvs force-pushed the 06-18-feat_onboarding_pill branch from c994062 to bbdf96e Compare June 19, 2026 15:44
@camielvs camielvs force-pushed the 06-17-feat_onboarding_checklist branch from a39fbd9 to ebc0b79 Compare June 19, 2026 15:51
@camielvs camielvs force-pushed the 06-18-feat_onboarding_pill branch from bbdf96e to 5ea2aaa Compare June 19, 2026 15:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

#gsd:50583 Learning Hub

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant