Files
hackerspace.sh/app/onboarding/onboarding-flow.tsx
T
Moheeb Zara 71d5e243cf feat: Customize hub + roles editor, terminal logo, invite links
IA refactor and the custom-roles editor pass 11 left as data-only.

Customize hub:
- New /customize (admin/board) with a left section rail: Roles,
  Membership tiers, Areas, Invite codes, Onboarding.
- One focused module per panel under app/(app)/customize/panels/
  plus a shared card and types file. The client shell is ~75 lines;
  each panel is self-contained (smart separation of concerns).
- Settings slimmed to Space, Integrations, Webhooks. Removed the
  Roles/Tiers/Invites/Onboarding tabs and the Areas block from
  settings-client.tsx (~700 lines) and the matching fetches from
  settings/page.tsx. Dead props/state/types removed.
- Sidebar: added a Customize NavLink (admin/board).

Roles editor:
- Rename/recolor the five built-in roles (upsertRoleLabel) and full
  CRUD on custom org roles. Adds the read path the audit flagged as
  missing: lib/role-labels.ts (getRoleLabelMap/roleDisplayName) is
  consumed in (app)/layout.tsx so the sidebar shows the renamed role.

Logo:
- Reverted the brand mark to the terminal >_ glyph
  (components/brand-mark.tsx) on the landing nav/footer, onboarding
  header, and favicon (public/logo.svg). Removed the dead local
  IcoTerminal. AtlasLogo stays only on the resources project page.

Invite links:
- InvitesPanel has Copy code and Copy link (/signup?invite=CODE).
  signup reads ?invite= on mount, prefills the code, preselects join.

Deferred and tracked in HANDOFF: types/database.ts sync, renamed-role
display on the members table, splitting the still-large
settings-client.tsx, custom-role assignment UI.

266/266 tests pass. Production build clean; /customize, /onboarding,
slimmed /settings all in the route table. No migration this pass.
2026-05-15 16:03:52 -07:00

240 lines
9.3 KiB
TypeScript

'use client'
import { useState } from 'react'
import { useRouter } from 'next/navigation'
import { toast } from 'sonner'
import { BrandMark } from '@/components/brand-mark'
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">
<BrandMark className="w-5 h-5 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>
)
}