polish(frontend): tighten the onboarding wizard's UX
- Drop "Logout" everywhere in the flow: nothing is persisted to the database until Garmin actually connects, so closing the tab is already a clean escape hatch -- no separate control needed. - Display-name step: replace the "Next" button with a small checkmark icon button next to the input (Enter still submits). - Garmin credentials step: drop "Previous" (changing the display name just means quitting and relaunching, since nothing is persisted yet) and rename "Next" to "Login". - MFA step: drop "Previous" for the same reason. - Once Garmin reports success (MFA or not), finish setup immediately instead of waiting on a "Continue to geniusrun" click.
This commit is contained in:
@@ -55,11 +55,20 @@
|
|||||||
max-width: 320px;
|
max-width: 320px;
|
||||||
}
|
}
|
||||||
|
|
||||||
.onboarding-wizard-actions {
|
.onboarding-wizard-name-row {
|
||||||
display: flex;
|
display: flex;
|
||||||
gap: 0.75rem;
|
gap: 0.5rem;
|
||||||
|
align-items: stretch;
|
||||||
}
|
}
|
||||||
|
|
||||||
.onboarding-wizard-actions button {
|
.onboarding-wizard-name-row input {
|
||||||
flex: 1;
|
flex: 1;
|
||||||
|
min-width: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.onboarding-wizard-icon-button {
|
||||||
|
flex: 0 0 auto;
|
||||||
|
padding: 0.6rem 0.9rem;
|
||||||
|
font-size: 1.1rem;
|
||||||
|
line-height: 1;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useState } from "react";
|
import { useEffect, useRef, useState } from "react";
|
||||||
import { api, BASE_URL } from "./api/client";
|
import { api } from "./api/client";
|
||||||
import "./OnboardingWizard.css";
|
import "./OnboardingWizard.css";
|
||||||
import type { AuthResponse } from "./types/api";
|
import type { AuthResponse } from "./types/api";
|
||||||
|
|
||||||
@@ -9,9 +9,10 @@ type Step = "name" | "garmin";
|
|||||||
// since nothing is persisted to the database until Garmin actually
|
// since nothing is persisted to the database until Garmin actually
|
||||||
// connects (see
|
// connects (see
|
||||||
// docs/superpowers/specs/2026-07-26-onboarding-wizard-deferred-commit-design.md).
|
// docs/superpowers/specs/2026-07-26-onboarding-wizard-deferred-commit-design.md).
|
||||||
// Quitting partway through (closing the tab, logging out) leaves no trace
|
// Quitting partway through (closing the tab) leaves no trace in the
|
||||||
// in the database -- there's no half-created account to clean up or
|
// database -- there's no half-created account to clean up or re-prompt
|
||||||
// re-prompt for later.
|
// for later, so there's deliberately no "Log out" escape hatch anywhere in
|
||||||
|
// this flow: closing the tab *is* the escape hatch.
|
||||||
export function OnboardingWizard({ onCreated }: { onCreated: (displayName: string) => void }) {
|
export function OnboardingWizard({ onCreated }: { onCreated: (displayName: string) => void }) {
|
||||||
const [step, setStep] = useState<Step>("name");
|
const [step, setStep] = useState<Step>("name");
|
||||||
const [displayName, setDisplayName] = useState("");
|
const [displayName, setDisplayName] = useState("");
|
||||||
@@ -21,6 +22,7 @@ export function OnboardingWizard({ onCreated }: { onCreated: (displayName: strin
|
|||||||
const [auth, setAuth] = useState<AuthResponse | null>(null);
|
const [auth, setAuth] = useState<AuthResponse | null>(null);
|
||||||
const [busy, setBusy] = useState(false);
|
const [busy, setBusy] = useState(false);
|
||||||
const [error, setError] = useState<string | null>(null);
|
const [error, setError] = useState<string | null>(null);
|
||||||
|
const completeTriggered = useRef(false);
|
||||||
|
|
||||||
function submitName(e: React.FormEvent) {
|
function submitName(e: React.FormEvent) {
|
||||||
e.preventDefault();
|
e.preventDefault();
|
||||||
@@ -75,26 +77,38 @@ export function OnboardingWizard({ onCreated }: { onCreated: (displayName: strin
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Once Garmin reports success (whether MFA was needed or not), finish
|
||||||
|
// setup immediately -- no "Continue to geniusrun" click required. Guarded
|
||||||
|
// by a ref (not just the effect's dependency array) so this can never
|
||||||
|
// fire twice, e.g. under React StrictMode's double-invoked effects in
|
||||||
|
// development.
|
||||||
|
useEffect(() => {
|
||||||
|
if (auth?.status === "authenticated" && !completeTriggered.current) {
|
||||||
|
completeTriggered.current = true;
|
||||||
|
complete();
|
||||||
|
}
|
||||||
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||||
|
}, [auth?.status]);
|
||||||
|
|
||||||
if (step === "name") {
|
if (step === "name") {
|
||||||
return (
|
return (
|
||||||
<div className="onboarding-wizard">
|
<div className="onboarding-wizard">
|
||||||
<h1>🧞♀️ Welcome to geniusrun</h1>
|
<h1>🧞♀️ Welcome to geniusrun</h1>
|
||||||
<p>Let's set up your profile. You'll connect your Garmin account next.</p>
|
<p>Let's set up your profile. You'll connect your Garmin account next.</p>
|
||||||
<form onSubmit={submitName}>
|
<form onSubmit={submitName}>
|
||||||
<input
|
<div className="onboarding-wizard-name-row">
|
||||||
type="text"
|
<input
|
||||||
placeholder="Display name"
|
type="text"
|
||||||
value={displayName}
|
placeholder="Display name"
|
||||||
onChange={(e) => setDisplayName(e.target.value)}
|
value={displayName}
|
||||||
autoFocus
|
onChange={(e) => setDisplayName(e.target.value)}
|
||||||
/>
|
autoFocus
|
||||||
|
/>
|
||||||
|
<button type="submit" className="onboarding-wizard-icon-button" title="Continue" aria-label="Continue">
|
||||||
|
✓
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
{error && <p className="onboarding-wizard-error">{error}</p>}
|
{error && <p className="onboarding-wizard-error">{error}</p>}
|
||||||
<button type="submit">Next</button>
|
|
||||||
</form>
|
|
||||||
<form method="post" action={`${BASE_URL}/api/session/logout`}>
|
|
||||||
<button type="submit" className="logout-link">
|
|
||||||
Log out
|
|
||||||
</button>
|
|
||||||
</form>
|
</form>
|
||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
@@ -107,10 +121,15 @@ export function OnboardingWizard({ onCreated }: { onCreated: (displayName: strin
|
|||||||
|
|
||||||
{auth?.status === "authenticated" ? (
|
{auth?.status === "authenticated" ? (
|
||||||
<>
|
<>
|
||||||
<p className="onboarding-wizard-message">Connected to Garmin.</p>
|
<p className="onboarding-wizard-message">Connected to Garmin — finishing setup…</p>
|
||||||
<button type="button" disabled={busy} onClick={complete}>
|
{error && (
|
||||||
{busy ? "Finishing…" : "Continue to geniusrun"}
|
<>
|
||||||
</button>
|
<p className="onboarding-wizard-error">{error}</p>
|
||||||
|
<button type="button" disabled={busy} onClick={complete}>
|
||||||
|
{busy ? "Finishing…" : "Retry"}
|
||||||
|
</button>
|
||||||
|
</>
|
||||||
|
)}
|
||||||
</>
|
</>
|
||||||
) : auth?.status === "mfa_required" ? (
|
) : auth?.status === "mfa_required" ? (
|
||||||
<div className="onboarding-wizard-mfa">
|
<div className="onboarding-wizard-mfa">
|
||||||
@@ -124,21 +143,9 @@ export function OnboardingWizard({ onCreated }: { onCreated: (displayName: strin
|
|||||||
/>
|
/>
|
||||||
{auth.message && <p className="onboarding-wizard-message">{auth.message}</p>}
|
{auth.message && <p className="onboarding-wizard-message">{auth.message}</p>}
|
||||||
{error && <p className="onboarding-wizard-error">{error}</p>}
|
{error && <p className="onboarding-wizard-error">{error}</p>}
|
||||||
<div className="onboarding-wizard-actions">
|
<button type="button" disabled={busy} onClick={submitMFA}>
|
||||||
<button
|
Submit code
|
||||||
type="button"
|
</button>
|
||||||
disabled={busy}
|
|
||||||
onClick={() => {
|
|
||||||
setAuth(null);
|
|
||||||
setError(null);
|
|
||||||
}}
|
|
||||||
>
|
|
||||||
Previous
|
|
||||||
</button>
|
|
||||||
<button type="button" disabled={busy} onClick={submitMFA}>
|
|
||||||
Submit code
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
</div>
|
</div>
|
||||||
) : (
|
) : (
|
||||||
<form onSubmit={submitGarmin}>
|
<form onSubmit={submitGarmin}>
|
||||||
@@ -159,29 +166,11 @@ export function OnboardingWizard({ onCreated }: { onCreated: (displayName: strin
|
|||||||
/>
|
/>
|
||||||
{auth?.message && <p className="onboarding-wizard-message">{auth.message}</p>}
|
{auth?.message && <p className="onboarding-wizard-message">{auth.message}</p>}
|
||||||
{error && <p className="onboarding-wizard-error">{error}</p>}
|
{error && <p className="onboarding-wizard-error">{error}</p>}
|
||||||
<div className="onboarding-wizard-actions">
|
<button type="submit" disabled={busy}>
|
||||||
<button
|
{busy ? "Connecting…" : "Login"}
|
||||||
type="button"
|
</button>
|
||||||
disabled={busy}
|
|
||||||
onClick={() => {
|
|
||||||
setStep("name");
|
|
||||||
setError(null);
|
|
||||||
}}
|
|
||||||
>
|
|
||||||
Previous
|
|
||||||
</button>
|
|
||||||
<button type="submit" disabled={busy}>
|
|
||||||
{busy ? "Connecting…" : "Next"}
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
</form>
|
</form>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
<form method="post" action={`${BASE_URL}/api/session/logout`}>
|
|
||||||
<button type="submit" className="logout-link">
|
|
||||||
Log out
|
|
||||||
</button>
|
|
||||||
</form>
|
|
||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user