Onboarding

Welcome sequence and user activation in Objectuve.

Overview

Onboarding in Objectuve is a single, unified 13-slide wizard that collects a first goal and Coach configuration in one sitting, followed by post-wizard interstitials that keep the momentum going without the friction of modal signup flows.

The system is designed around three core principles:

• Sidebar-zero contract — The wizard stays focused; invite prompts surface post-wizard, not mid-flow
• Immediate reward — First goal creation triggers confetti, badges, and XP within seconds
• Social proof early — Community joining and ally invites are prompted when users are most motivated (right after they've proven they'll use the app)

The Flow

1. Wizard (13 slides)

The wizard runs at /welcome/:slideId and combines goal creation with Coach configuration in a single registry — there are no separate "goal builder" and "coach builder" phases and no A/B variants; every user sees the same slides in the same order:

1. Intro
2. Life area
3. Goal name
4. Goal shape (+ target date)
5. Goal why
6. Coach persona
7. Coach tone
8. Coach focus
9. Coach rhythm
10. Goal motivation snapshot
11. Source attribution (auto-skipped if already known from a URL)
12. Review (currently always skipped)
13. Done

For the exact, up-to-date slide-by-slide breakdown, see Onboarding Flow (technical) — that document is the source of truth for slide order, validation, and state; this page intentionally does not duplicate the list to avoid drift.

See Coach Builder for persona options and tone details, and Goal Builder for the goal-construction slides.

An optional, skippable "Our Philosophy" slide (v4.1 Phase 3) can appear early in the wizard, behind the onboarding_pledge_enabled flag — it surfaces the same anti-addictive-design values shown on the public /our-story page (from one shared source, so the two never drift). See Onboarding Flow (technical) § Philosophy slide for the full contract.

2. First Goal Creation

The Done slide submits the wizard. This is the activation trigger for:

• Badges: first_sign_in and create_first_goal badges unlock
• Gamification: XP awarded, streak begins
• Celebrate: Confetti animation + achievement toast
• Next step: Post-goal interstitials surface (e.g., "Better Together" ally invite for v1.16+)

If the user named a goal, the Done slide calls the atomic CompleteOnboardingAndCreateGoal mutation. If they didn't, it stores onboarding state only and routes to /goals/create to finish there. See Goal Builder and Onboarding Flow (technical) for the full mechanics.

3. Post-Wizard Interstitials (Days 0–1)

Once the user lands on the Dashboard after first goal creation, optional interstitials fire:

• Better Together (v1.16) — Explanation of shared-streak mechanic + one-tap ally invite. Skippable, feature-flagged.
• Welcome Back — Returning users (post-session) see a motivational modal. See WelcomeBackInterstitial.vue.
• Coach Warmup Card (OBJ-2165) — A 3-question Coach preference card (time of day, missed-day response, feedback style), shown once right after wizard-exit. Enters the interstitial stack at tier 5 — behind Streak Repair, Welcome Back, and Better Together — and is gated behind the coach-warmup-card flag. See CoachWarmupCard.vue and Coach § Cold-Start Warmup Context.
• Onboarding Check — Dashboard detects onboarding state via completedOnboarding flag and surfaces relevant CTAs (invite ally, join community, etc.)

4. Community & Social (Days 1–7)

By day 7, the system encourages:

• Community joining — Browse discovery or accept ally invites to join communities
• Ally invites — Early users see ally-request prompts post-goal-creation
• Founding Member badge — Join a community within 30 days of its creation → earn epic badge

See Communities and Allies for details.

30-Day Arc & Gamification

The full 30-day onboarding arc is documented in the Onboarding Timeline with:

• Day-by-day milestone expectations
• Gamification trigger timeline (badge unlocks, level progression, XP curves)
• Activation KPIs and engagement signals
• Expected user progression from "Curious → Accomplished → Activated"

Related Features

Topic	Details
Coach Setup	Coach Builder — Persona, tone, focus, frequency selection
Goal Creation	Goal Builder — Guided goal construction slides
Motivation Profiling	Onboarding Flow (technical) — Goal motivation snapshot (Slide 10, unconditional for all users since Phase 93.1)
Activation Metrics	Onboarding Timeline — 30-day arc, milestones, badge/XP timeline
Gamification	Gamification Engine — XP awards, badge unlocks, level progression
Social Setup	Allies — Ally request acceptance, invite mechanics
Community Joining	Communities — Community discovery, founding window, join flow
Dashboard	Dashboard — Onboarding state detection, quick check-in, empty states

User-Facing Onboarding

For end-user walkthrough and getting started guides, see User Guide.

---

Last updated: 2026-08-07 (OBJ-2165: added the tier-5 Coach Warmup Card to the post-wizard interstitial stack)

Previous update — 2026-07-07