From 5bdb3e6268ccce08f8fe9f44206505d8972194f1 Mon Sep 17 00:00:00 2001 From: archipelago Date: Thu, 30 Jul 2026 18:32:18 -0400 Subject: [PATCH] docs: capture todo - onboarding tickbox hidden below fold on short screens --- .planning/STATE.md | 1 + ...kbox-hidden-below-fold-on-short-screens.md | 22 +++++++++++++++++++ 2 files changed, 23 insertions(+) create mode 100644 .planning/todos/pending/2026-07-30-onboarding-tickbox-hidden-below-fold-on-short-screens.md diff --git a/.planning/STATE.md b/.planning/STATE.md index f7381dc4..53c0a2e9 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -104,6 +104,7 @@ Decisions are logged in PROJECT.md (10 locked ADRs in the `` 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 diff --git a/.planning/todos/pending/2026-07-30-onboarding-tickbox-hidden-below-fold-on-short-screens.md b/.planning/todos/pending/2026-07-30-onboarding-tickbox-hidden-below-fold-on-short-screens.md new file mode 100644 index 00000000..ef1e7fb4 --- /dev/null +++ b/.planning/todos/pending/2026-07-30-onboarding-tickbox-hidden-below-fold-on-short-screens.md @@ -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).