#126 — Re-triggers the Tour on Every Mount for Returning Users (No Dismiss Persistence)

[Topmatrixmor2014]

Labels: Official Campaign | FWC26 GrantFox OSS Maybe Rewarded frontend onboarding ux bug

This is a frontend issue for the GrantFox FWC26 campaign. Persist tour dismissal so returning users aren't re-greeted on every page load.

Requirements and Context

frontend/hooks/useOnboardingTour.ts:

• The hook decides to show the tour based on the onboarding state; if a user dismisses the tour mid-way (or finishes it) the completion/dismissal may only be tracked in memory for the session, not persisted — so the tour re-appears on the next mount.
• The tour also lacks a "don't show again" flag that survives across sessions; the existing onboardingState.ts only records step progress.

Objectives

1. Persist a dismissed/completedAt flag in onboardingState.ts and have the hook skip the tour when set.
2. Add a "Skip and don't show again" action on the tour.
3. Add tests: dismissal persists; tour doesn't re-trigger on remount.

Suggested Execution

1. Fork and branch: git checkout -b fix/onboarding-dismissal.
2. Patch useOnboardingTour.ts + onboardingState.ts.
3. Add tests; run npm run lint && npm run type-check && npm test in frontend/.

Acceptance Criteria

• Dismissing the tour persists across reloads.
• Returning users are not re-greeted.
• ≥2 tests; npm run lint, npm run type-check, npm test pass.

Guidelines

• Keep the tour accessible from settings even when dismissed.

Timeframe: 24 hours

[github-actions]

🤖 Greptile AI Context

Greptile has indexed this repository and can provide AI-assisted code review
and context for this issue.

How to use Greptile on this issue:

• Comment @greptileai to ask about relevant code, files, or implementation approaches
• Reference specific files or error messages for targeted analysis
• Use @greptileai explain <file> to get an explanation of any file

Greptile is configured with project-specific rules in .greptile/config.json.

[waterWang]

Hi! I'll work on this issue — persisting tour dismissal across sessions.

[Abuh-Bakar]

Hi maintainer, I would love to work on this. I have implemeted similar solutions on several projects and I can do same here cleanly and efficiently. Allow me the opportunity to contribute to your project while following contribution guidelines for your project. Kindly assign.

[grantfox-oss]

🦊 GrantFox — @Abuh-Bakar has been assigned to this issue as part of the Third Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #903)
2. Your PR will be reviewed by the FinChippay maintainers

Good luck! Track your progress on GrantFox.