Skip to content

Conversation

@ibetitsmike
Copy link
Contributor

Summary

Introduce a guided tutorial system that shows tooltips on first use to help new users discover key features.

Tutorial Sequences

  1. Settings (on app launch): Points to the settings gear icon
  2. Creation (when creating workspace): Walks through Model selector → Exec/Plan mode → From branch → Runtime selector
  3. Workspace (when entering a workspace): Highlights the terminal button

Features

  • Dismissible: Each sequence marks as completed when dismissed or finished
  • Disable option: Users can select "Don't show again" to disable all tutorials
  • Highlight effect: Target elements get a pulsing accent border to draw attention
  • Smart positioning: Tooltips auto-flip to stay in viewport bounds

Implementation

  • TutorialState persisted in localStorage with completion tracking per sequence
  • TutorialProvider context manages active sequence and step progression
  • TutorialTooltip renders portal-based tooltip with backdrop and arrow
  • Clean separation via data-tutorial attributes on target elements

Generated with mux

@ibetitsmike ibetitsmike force-pushed the mux-tutorial-tooltips branch 10 times, most recently from aef3911 to d1474d9 Compare November 30, 2025 06:48
Introduce a guided tutorial system that shows tooltips on first use:

- Settings tooltip on app launch (points to gear icon)
- Creation flow tooltips (Model, Exec/Plan, From branch, Runtime)
- Workspace tutorial (Terminal icon)

Each sequence can be dismissed individually, and users can opt to
disable all tutorials via 'Don't show again' option.

Implementation:
- TutorialState persisted in localStorage with completion tracking
- TutorialProvider context manages active sequence and step progression
- TutorialTooltip renders portal-based tooltip with highlight effect
- data-tutorial attributes on target elements for clean separation

_Generated with mux_
@ibetitsmike ibetitsmike force-pushed the mux-tutorial-tooltips branch from d1474d9 to 8590a5e Compare November 30, 2025 06:56
…other stories

- Add TutorialTooltip.stories.tsx with stories for:
  - Single step tutorial
  - Multi-step tutorials (first, middle, last)
  - All position variants (top, bottom, left, right)
- Add tutorialEnabled parameter to preview config
- Disable tutorials by default in all stories via decorator
- Individual stories can opt-in via parameters.tutorialEnabled = true
@ibetitsmike ibetitsmike added this pull request to the merge queue Nov 30, 2025
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Nov 30, 2025
@ibetitsmike ibetitsmike added this pull request to the merge queue Nov 30, 2025
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Nov 30, 2025
@ibetitsmike ibetitsmike added this pull request to the merge queue Nov 30, 2025
Merged via the queue into main with commit a2a95af Nov 30, 2025
17 of 19 checks passed
@ibetitsmike ibetitsmike deleted the mux-tutorial-tooltips branch November 30, 2025 12:59
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.

1 participant