Skip to content

Beginner UX: soft first-run readiness card on Home - #11282

Merged
diegosouzapw merged 2 commits into
diegosouzapw:release/v3.8.50from
ignamiranda:contributor/feat/beginner-ux-onboarding
Aug 23, 2026
Merged

diegosouzapw merged 2 commits into
diegosouzapw:release/v3.8.50from
ignamiranda:contributor/feat/beginner-ux-onboarding

Conversation

@ignamiranda

@ignamiranda ignamiranda commented Aug 23, 2026 •

Copy link
Copy Markdown
Contributor

Summary - Replace the hard redirect from Home → /dashboard/onboarding when setupComplete is false with a dismissable First-run readiness card. - Returning users can dismiss the card (localStorage) and stay on Home; new users get a clear 4-step path + Continue CTA. - Adds FirstRunReadinessCard and home.readiness* i18n keys; static unit test guards the no-redirect contract. ## Pitch Pitch #3 — Soft first-run readiness (Wave 4). Tracking: beginner UX HTML pitch series. ## Test plan - [x] node --import tsx/esm --test tests/unit/home-page-static.test.ts (4/4 pass) - [ ] Manual: fresh install / setupComplete=false shows readiness card on Home - [ ] Manual: Dismiss hides card across reload; Continue opens onboarding wizard - [ ] Manual: setupComplete=true never shows the card

Notes

⚠️ base-red inherited: #9985

Related: #11167

@ignamiranda

Copy link
Copy Markdown
Contributor Author

⚠️ base-red inherited: #9985

Docs Gates failure (OMNIROUTE_BUILDING missing from .env.example) is present on
elease/v3.8.50 tip and is unrelated to this PR's diff (Home readiness card + i18n + static test only).

@diegosouzapw
diegosouzapw merged commit 3abbb60 into diegosouzapw:release/v3.8.50 Aug 23, 2026
8 of 16 checks passed
muhamadgalihsaputra pushed a commit to niyatna/NiyatnaRoute that referenced this pull request Sep 27, 2026
Validated on the combined 8-PR board: home-page-static 4/4, check:dashboard-typecheck clean (220 pre-existing, all within frozen baseline — zero syntax errors), 88/88 across the board's focused suites, static gates within baseline. The soft first-run readiness card replaces the hard Home→onboarding redirect with a dismissable 4-step path. Thank you @ignamiranda!
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.

2 participants