docs: capture todo - onboarding tickbox hidden below fold on short screens

This commit is contained in:
archipelago 2026-07-30 18:32:18 -04:00
parent 99ecb95f53
commit 5bdb3e6268
2 changed files with 23 additions and 0 deletions

View File

@ -104,6 +104,7 @@ Decisions are logged in PROJECT.md (10 locked ADRs in the `<decisions>` block +
- [blocker/ui] Keep FIPS/Tor pills on cloud files and show them on mobile (`.planning/todos/pending/2026-07-30-keep-fips-tor-pills-on-cloud-files-and-show-them-on-mobile.md`)
- [blocker/security] Fedimint gateway must not install with a pre-set password — tracked as FED-07 / Phase 1 gap plan (`.planning/todos/pending/2026-07-30-fedimint-gateway-must-not-install-with-preset-password.md`)
- [blocker/ui] Connected-nodes list must scroll at row-matched height, not grow to fit (`.planning/todos/pending/2026-07-30-connected-nodes-list-must-scroll-at-row-matched-height.md`)
- [blocker/ui] Onboarding tickbox hidden below fold on short screens — make it beautifully obvious (`.planning/todos/pending/2026-07-30-onboarding-tickbox-hidden-below-fold-on-short-screens.md`)
### Blockers/Concerns

View File

@ -0,0 +1,22 @@
---
created: 2026-07-30T22:19:31.770Z
title: Onboarding tickbox hidden below fold on short screens — make it beautifully obvious
area: ui
severity: blocker
files:
- neode-ui/src/views/OnboardingSeedGenerate.vue
- neode-ui/src/views/OnboardingWrapper.vue
---
## Problem
Dorian reports (2026-07-30): on shorter screens, the onboarding screen's tickbox (the seed-phrase confirmation checkbox in `OnboardingSeedGenerate.vue` — verify it's this step) sits below the fold inside a scrollable area, and it's not obvious it exists — users don't realize they need to scroll to find it, so onboarding appears stuck. Blocker: this stalls new-user onboarding on small displays.
## Solution
Make its presence obvious "in a beautiful way" (Dorian's words — design discretion, but it must feel intentional and match the house glass/dark style, not a bolted-on arrow). Candidate approaches to evaluate:
- A soft bottom scroll-affordance: gradient fade at the container's bottom edge plus a subtle animated chevron/pulse when unscrolled content remains, disappearing once the tickbox is in view.
- Or make the tickbox + continue button a sticky footer of the card on short viewports so it's always visible, with the seed content scrolling behind it.
- Or auto-scroll/nudge the container after the seed is revealed.
Constraints: follow the standing rule — don't alter the existing onboarding look beyond this affordance; keep desktop/tall-screen appearance unchanged; whatever ships must be verified on an actual short viewport (e.g. small laptop / mobile landscape).