feat: configurable member onboarding + UX/persona research
A new member who joins via invite code now walks through an admin-defined onboarding sequence before reaching the app. Schema (migration 022, folded into schema.sql Section 14): - space_onboarding_steps: step_key, step_type (welcome|code_of_conduct|profile|payment|content), title, body, config jsonb, is_enabled, is_required, is_system, sort_order, unique per (space, step_key). Full RLS: members read, admin/board write, admin delete non-system. - space_members.onboarding_completed_at + onboarding_progress jsonb. - Trigger seeds four default steps per space (welcome, code of conduct [required], profile, dues). Backfill seeds existing spaces and marks all existing members complete so the new gate never traps them. Flow: - /onboarding (top-level route, outside the (app) group so no redirect loop). Progress bar, step counter, back/continue, per-type rendering. Profile step calls updateMyProfile; payment step is a non-blocking nudge with optional link and "Remind me later". - (app)/layout.tsx redirects to /onboarding while onboarding_completed_at is null. - createSpace marks the founder complete: founders configure the space, they do not run the member flow (matches admin-vs-end-user persona research). - finishOnboarding re-checks required steps server-side so a tampered client cannot skip a required code-of-conduct acknowledgement. skipOnboarding only works when nothing is required. Admin config: - Settings -> Onboarding tab: reorder, edit title/body/payment link, toggle enabled/required, add custom content steps, delete non-system steps. Safety: - components/safe-markdown.tsx renders admin-authored markdown and a sanitized subset of HTML (rehype-raw + rehype-sanitize). Added those two deps. Also: - bio added to updateMyProfileSchema (members can self-set it; not blocked by the migration-015 trigger). - docs/UX_AND_PERSONAS.md: 4 personas and prioritized UX audit findings. Onboarding was finding #1; 2-6 deferred and tracked. 266/266 unit tests pass. Production build clean, /onboarding in the route table. Migration 022 applies idempotently on the next deploy.
This commit is contained in:
Moheeb Zara
@@ -0,0 +1,239 @@
|
||||
'use client'
|
||||
|
||||
import { useState } from 'react'
|
||||
import { useRouter } from 'next/navigation'
|
||||
import { toast } from 'sonner'
|
||||
import { AtlasLogo } from '@/components/resources/atlas-logo'
|
||||
import { SafeMarkdown } from '@/components/safe-markdown'
|
||||
import {
|
||||
markOnboardingStepDone,
|
||||
finishOnboarding,
|
||||
skipOnboarding,
|
||||
updateMyProfile,
|
||||
} from '@/lib/actions'
|
||||
|
||||
type StepType = 'welcome' | 'code_of_conduct' | 'profile' | 'payment' | 'content'
|
||||
|
||||
interface Step {
|
||||
id: string
|
||||
step_type: StepType
|
||||
title: string
|
||||
body: string | null
|
||||
config: Record<string, unknown>
|
||||
is_required: boolean
|
||||
}
|
||||
|
||||
interface Props {
|
||||
spaceName: string
|
||||
steps: Step[]
|
||||
canSkip: boolean
|
||||
profile: {
|
||||
display_name: string
|
||||
handle: string
|
||||
bio: string
|
||||
skills: string[]
|
||||
interests: string[]
|
||||
}
|
||||
}
|
||||
|
||||
export function OnboardingFlow({ spaceName, steps, canSkip, profile: initialProfile }: Props) {
|
||||
const router = useRouter()
|
||||
const [index, setIndex] = useState(0)
|
||||
const [busy, setBusy] = useState(false)
|
||||
const [acked, setAcked] = useState<Record<string, boolean>>({})
|
||||
const [profile, setProfile] = useState(initialProfile)
|
||||
|
||||
const step = steps[index]
|
||||
const isLast = index === steps.length - 1
|
||||
const requireAck = step.config?.require_ack === true
|
||||
const ackLabel = (step.config?.ack_label as string) || 'I have read and agree'
|
||||
const ackOk = !requireAck || acked[step.id]
|
||||
|
||||
async function advance() {
|
||||
setBusy(true)
|
||||
await markOnboardingStepDone(step.id)
|
||||
setBusy(false)
|
||||
if (isLast) {
|
||||
await finish()
|
||||
} else {
|
||||
setIndex(i => i + 1)
|
||||
}
|
||||
}
|
||||
|
||||
async function finish() {
|
||||
setBusy(true)
|
||||
const result = await finishOnboarding()
|
||||
setBusy(false)
|
||||
if (result.error) { toast.error(result.error); return }
|
||||
router.push('/dashboard')
|
||||
}
|
||||
|
||||
async function handleSkipAll() {
|
||||
setBusy(true)
|
||||
const result = await skipOnboarding()
|
||||
setBusy(false)
|
||||
if (result.error) { toast.error(result.error); return }
|
||||
router.push('/dashboard')
|
||||
}
|
||||
|
||||
async function saveProfileAndAdvance() {
|
||||
setBusy(true)
|
||||
const result = await updateMyProfile({
|
||||
display_name: profile.display_name.trim() || undefined,
|
||||
handle: profile.handle.trim() || null,
|
||||
bio: profile.bio.trim() || null,
|
||||
skills: profile.skills,
|
||||
interests: profile.interests,
|
||||
})
|
||||
if ('error' in result && result.error) { setBusy(false); toast.error(result.error); return }
|
||||
await markOnboardingStepDone(step.id)
|
||||
setBusy(false)
|
||||
if (isLast) await finish()
|
||||
else setIndex(i => i + 1)
|
||||
}
|
||||
|
||||
const progressPct = Math.round(((index) / steps.length) * 100)
|
||||
|
||||
return (
|
||||
<div className="min-h-screen bg-sidebar flex flex-col">
|
||||
<header className="px-4 md:px-6 py-4 flex items-center gap-2 border-b border-sidebar-border">
|
||||
<AtlasLogo className="w-6 h-6 text-primary" />
|
||||
<span className="font-mono text-sm font-bold text-white">{spaceName}</span>
|
||||
{canSkip && (
|
||||
<button
|
||||
onClick={handleSkipAll}
|
||||
disabled={busy}
|
||||
className="ml-auto font-mono text-[11px] text-sidebar-foreground/60 hover:text-white transition"
|
||||
>
|
||||
Skip for now
|
||||
</button>
|
||||
)}
|
||||
</header>
|
||||
|
||||
<div className="h-1 bg-sidebar-border">
|
||||
<div className="h-1 bg-primary transition-all duration-300" style={{ width: `${progressPct}%` }} />
|
||||
</div>
|
||||
|
||||
<main className="flex-1 flex items-start justify-center p-4 md:p-8">
|
||||
<div className="w-full max-w-2xl bg-card border border-border rounded-lg mt-6 md:mt-12">
|
||||
<div className="px-6 py-4 border-b border-border flex items-center justify-between">
|
||||
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase">
|
||||
Step {index + 1} of {steps.length}
|
||||
</p>
|
||||
{step.is_required && (
|
||||
<span className="font-mono text-[10px] text-amber-600">required</span>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="px-6 py-6">
|
||||
<h1 className="font-sans text-xl font-semibold text-foreground mb-4">{step.title}</h1>
|
||||
|
||||
{step.step_type === 'profile' ? (
|
||||
<div className="space-y-4">
|
||||
{step.body && <SafeMarkdown>{step.body}</SafeMarkdown>}
|
||||
<div>
|
||||
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">Display name</label>
|
||||
<input
|
||||
type="text"
|
||||
value={profile.display_name}
|
||||
onChange={e => setProfile({ ...profile, display_name: e.target.value })}
|
||||
maxLength={100}
|
||||
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">Handle</label>
|
||||
<input
|
||||
type="text"
|
||||
value={profile.handle}
|
||||
onChange={e => setProfile({ ...profile, handle: e.target.value })}
|
||||
maxLength={50}
|
||||
placeholder="optional"
|
||||
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">Bio</label>
|
||||
<textarea
|
||||
value={profile.bio}
|
||||
onChange={e => setProfile({ ...profile, bio: e.target.value })}
|
||||
rows={3}
|
||||
maxLength={2000}
|
||||
placeholder="optional"
|
||||
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">Skills (comma separated)</label>
|
||||
<input
|
||||
type="text"
|
||||
defaultValue={profile.skills.join(', ')}
|
||||
onChange={e => setProfile({ ...profile, skills: e.target.value.split(',').map(s => s.trim()).filter(Boolean).slice(0, 40) })}
|
||||
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
) : step.step_type === 'payment' ? (
|
||||
<div className="space-y-4">
|
||||
{step.body && <SafeMarkdown>{step.body}</SafeMarkdown>}
|
||||
{typeof step.config?.payment_url === 'string' && step.config.payment_url && (
|
||||
<a
|
||||
href={step.config.payment_url as string}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 bg-primary text-white text-sm font-sans px-4 py-2 rounded hover:bg-primary/90 transition"
|
||||
>
|
||||
Set up payment
|
||||
</a>
|
||||
)}
|
||||
</div>
|
||||
) : (
|
||||
<div className="space-y-4">
|
||||
{step.body && <SafeMarkdown>{step.body}</SafeMarkdown>}
|
||||
{requireAck && (
|
||||
<label className="flex items-start gap-2 cursor-pointer">
|
||||
<input
|
||||
type="checkbox"
|
||||
checked={!!acked[step.id]}
|
||||
onChange={e => setAcked({ ...acked, [step.id]: e.target.checked })}
|
||||
className="mt-0.5"
|
||||
/>
|
||||
<span className="font-sans text-sm text-foreground">{ackLabel}</span>
|
||||
</label>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div className="px-6 py-4 border-t border-border flex items-center justify-between gap-3">
|
||||
<button
|
||||
onClick={() => setIndex(i => Math.max(0, i - 1))}
|
||||
disabled={index === 0 || busy}
|
||||
className="font-sans text-sm text-muted-foreground hover:text-foreground transition disabled:opacity-40"
|
||||
>
|
||||
Back
|
||||
</button>
|
||||
<div className="flex items-center gap-2">
|
||||
{step.step_type === 'payment' && !isLast && (
|
||||
<button
|
||||
onClick={advance}
|
||||
disabled={busy}
|
||||
className="font-sans text-sm text-muted-foreground hover:text-foreground transition px-3 py-2"
|
||||
>
|
||||
Remind me later
|
||||
</button>
|
||||
)}
|
||||
<button
|
||||
onClick={step.step_type === 'profile' ? saveProfileAndAdvance : advance}
|
||||
disabled={busy || !ackOk}
|
||||
className="bg-primary text-white text-sm font-sans px-4 py-2 rounded hover:bg-primary/90 transition disabled:opacity-50"
|
||||
>
|
||||
{busy ? 'Saving...' : isLast ? 'Finish' : step.step_type === 'payment' ? 'I have set this up' : 'Continue'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</main>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,64 @@
|
||||
import { redirect } from 'next/navigation'
|
||||
import { createClient } from '@/lib/supabase/server'
|
||||
import { OnboardingFlow } from './onboarding-flow'
|
||||
|
||||
export const dynamic = 'force-dynamic'
|
||||
|
||||
export default async function OnboardingPage() {
|
||||
const supabase = await createClient()
|
||||
const { data: { user } } = await supabase.auth.getUser()
|
||||
if (!user) redirect('/login')
|
||||
|
||||
const { data: member } = await supabase
|
||||
.from('space_members')
|
||||
.select('id, space_id, display_name, handle, bio, phone, skills, interests, onboarding_completed_at, spaces(name)')
|
||||
.eq('user_id', user.id)
|
||||
.in('status', ['current', 'unverified', 'late'])
|
||||
.order('joined_at', { ascending: true })
|
||||
.limit(1)
|
||||
.maybeSingle()
|
||||
|
||||
if (!member) redirect(`/signup?email=${encodeURIComponent(user.email || '')}`)
|
||||
if (member.onboarding_completed_at) redirect('/dashboard')
|
||||
|
||||
const { data: steps } = await supabase
|
||||
.from('space_onboarding_steps')
|
||||
.select('id, step_key, step_type, title, body, config, is_required')
|
||||
.eq('space_id', member.space_id)
|
||||
.eq('is_enabled', true)
|
||||
.order('sort_order', { ascending: true })
|
||||
|
||||
// No steps configured: nothing to show. Mark complete and move on.
|
||||
if (!steps || steps.length === 0) {
|
||||
await supabase
|
||||
.from('space_members')
|
||||
.update({ onboarding_completed_at: new Date().toISOString() })
|
||||
.eq('id', member.id)
|
||||
redirect('/dashboard')
|
||||
}
|
||||
|
||||
const canSkip = !steps.some(s => s.is_required)
|
||||
const spaceName = (member.spaces as { name?: string } | null)?.name ?? 'your space'
|
||||
|
||||
return (
|
||||
<OnboardingFlow
|
||||
spaceName={spaceName}
|
||||
steps={steps.map(s => ({
|
||||
id: s.id,
|
||||
step_type: s.step_type as 'welcome' | 'code_of_conduct' | 'profile' | 'payment' | 'content',
|
||||
title: s.title,
|
||||
body: s.body,
|
||||
config: (s.config ?? {}) as Record<string, unknown>,
|
||||
is_required: s.is_required,
|
||||
}))}
|
||||
canSkip={canSkip}
|
||||
profile={{
|
||||
display_name: member.display_name ?? '',
|
||||
handle: member.handle ?? '',
|
||||
bio: member.bio ?? '',
|
||||
skills: (member.skills as string[] | null) ?? [],
|
||||
interests: (member.interests as string[] | null) ?? [],
|
||||
}}
|
||||
/>
|
||||
)
|
||||
}
|
||||
Reference in New Issue
Block a user