Skip to content

Stop the tour and advice toasts from opening by themselves - #1122

Merged
cugarteblair merged 1 commit into
mainfrom
issue-1088-revisit-tour-popups
Sep 28, 2026
Merged

cugarteblair merged 1 commit into
mainfrom
issue-1088-revisit-tour-popups

Conversation

@cugarteblair

Copy link
Copy Markdown
Member

Summary

Issue #1088: on a managed browser that wipes site storage every few weeks, each update made the client act as if it were a first visit. The Quick Tour started as a blocking intro.js overlay (step 4 covers the Run button), and up to nine "Helpful Advice" toasts appeared top-left for 60 s. Those toasts were gated on having fewer than 2–4 stored records, not on a "seen" flag.

We can't make storage survive for anonymous users, so this makes losing it harmless:

  • No auto-start. App.vue no longer starts the Quick Tour on mount.
  • Tour → Help menu (SrAppBar.vue): Quick Tour, Long Tour (disabled off the map views) and a Show tips switch. The button shows on every route and pulses until first opened; prefers-reduced-motion gets a static glow.
  • Tips are opt-in. requestsStore.showTip() replaces displayHelpfulMapAdvice / displayHelpfulPlotAdvice / needAdvice and helpfulReqAdviceCnt; all nine call sites use it.
  • Tips requested together share one toast. The Analysis view fired five at once (one a duplicate from two SrPlotConfig instances). showTip now collects tips for 300 ms, drops duplicates and shows one toast (utils/tipUtils.ts) that stays up 4 s + 0.5 s per word; hovering pauses it.
  • helpStore replaces tourStore (persisted to localStorage: helpOpened, showTips). It migrates the legacy srTourSeen key once, so existing users don't see the pulse.
  • The no-region error in workerDomUtils.ts includes its advice instead of adding a second toast.
  • Settings: "Reset Quick Tour" → "Reset Help & Tips"; the obsolete "Threshold for Helpful Advice" input is removed.

Closes #1088

Test plan

  • make pre-commit-check passed on commit (lockfiles, lint-staged, typecheck, unit tests incl. new helpStore.spec.ts and tipUtils.spec.ts)
  • make test-e2e on Chromium: new help_menu.e2e.spec.ts, plus the existing specs on the renamed appPage fixture
  • Firefox E2E (browser not installed locally; CI covers it)
  • Visual check on a preview build: the pulse, the Help menu, the Show tips icon toggle, the combined Analysis-view tips toast

🤖 Generated with Claude Code

A managed browser that wipes site storage every few weeks made the
client treat each update as a first visit: the Quick Tour started as a
blocking overlay over the Run button, and "Helpful Advice" toasts
(gated on having fewer than 2-4 stored records) stayed for 60 s over
the request controls.

Losing that storage is now harmless. Nothing advice-like opens on its
own; the app-bar Tour button becomes a Help menu (Quick Tour, Long
Tour, Show tips) that pulses until it is first opened. Tips are off by
default and all go through requestsStore.showTip. Tips requested
together (one view mounting) are combined into one toast, duplicates
dropped, that stays up 4 s plus 0.5 s per word.

The new helpStore replaces tourStore and migrates the old srTourSeen
key so existing users don't see the pulse. The no-region error now
carries its own advice instead of a second toast, and the obsolete
"Threshold for Helpful Advice" setting is removed.

The E2E fixture that clicked through the auto-started tour becomes
appPage; help_menu.e2e.spec.ts covers the new first-visit behavior.

Closes #1088

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cugarteblair
cugarteblair merged commit 6566135 into main Sep 28, 2026
1 check passed
@cugarteblair
cugarteblair deleted the issue-1088-revisit-tour-popups branch September 28, 2026 13:12
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.

Revisit design of when helpful advice pops up

1 participant