Skip to main content

Onboarding

Status: ✅ Built (2026-07-02) — RW-10 shipped; deferred items noted below.

Scope​

The critical activation path for a new family. Steps: create household, set up admin's member profile, add/invite other members (or create shadow members for children), configure economy (currency name, currencyPerToken, default allocation), and create the first chore or routine. A skippable wizard reduces drop-off; each step can be returned to via Admin.

Built (2026-07-02)​

RW-10 shipped the full wizard (6 steps):

  1. Household — name (80-char gate) + emoji.
  2. Add first kid — display name + optional DOB (shadow member; under-13 shows consent step, 13+ skips it, unknown age shows it as a precaution per COPPA).
  3. Parental consent — spelled-out VPC copy; existing owner-only captureConsent path; skip records nothing (verified via verifyNever).
  4. Economy config — rate chips for currencyPerToken; existing updateEconomyConfig verb; EarningsSplit untouched.
  5. First chore — 3 quick-start templates; token value → bounty / 0 → expectation-assigned.
  6. Checklist — deep-links back into the app for deferred steps.

TermsSessionGate (shell-level) covers adult terms acceptance (FR-ONBOARD-2).

Decisions settled during build​

  • Wizard depth — full 6-step wizard; each step skippable; checklist persists as deep-links (not cross-restart resume — deferred).
  • Shadow-member promotion — no dedicated promotion flow for MVP-1; shadow member is created by admin, gains auth identity via a future invite flow.
  • Co-parent invite — FR-ONBOARD-4 deferred; inviteCoParent facade verb not yet wired; step not in wizard for MVP-1.
  • Checklist persistence — deep-link-only for MVP-1; cross-restart resume deferred (FR-ONBOARD-7).
  • Consent ordering — ⚖️ counsel item; wizard shows consent after first-kid step as implemented; final ordering pending legal sign-off.

Relationship​

Admin — all onboarding config is editable post-setup in the Admin area.