Welcome Modal
Onboarding dialog: an illustrated tinted header (sprout growing with each step), serif title and copy, leaf-shaped step dots, Back/Next pills and “Let’s begin” on the last step.
organic-soft/ui/welcome-modalSource
"use client";
import { useState, type ReactNode } from "react";
import { Dialog } from "radix-ui";
import { cn } from "@/lib/utils";
export interface WelcomeStep {
title: string;
text: string;
tone: "sage" | "clay" | "sand";
}
export interface WelcomeModalProps {
trigger?: ReactNode;
defaultOpen?: boolean;
steps?: WelcomeStep[];
onFinish?: () => void;
da?: string;
}
const TONE = { sage: "bg-da-accent text-da-accent-fg", clay: "bg-da-secondary text-da-secondary-fg", sand: "bg-da-muted text-da-fg" } as const;
const DEFAULT_STEPS: WelcomeStep[] = [
{ title: "Welcome to Grove", text: "Let’s get your first footprint in an afternoon. We’ll go gently.", tone: "sage" },
{ title: "Connect your tools", text: "Accounting, cloud and travel — Grove reads the numbers so you don’t have to.", tone: "clay" },
{ title: "Pick your first actions", text: "We’ll suggest three changes with the most impact for the least effort.", tone: "sand" },
];
/** Onboarding dialog: an illustrated tinted header (sprout growing with each step), serif title and copy, leaf-shaped step dots, Back/Next pills and “Let’s begin” on the last step. */
export function WelcomeModal({ trigger, defaultOpen, steps = DEFAULT_STEPS, onFinish, da = "organic-soft" }: WelcomeModalProps) {
const [open, setOpen] = useState(defaultOpen ?? false);
const [i, setI] = useState(0);
const s = steps[i] ?? steps[0]!;
const last = i === steps.length - 1;
return (
<Dialog.Root
open={open}
onOpenChange={(o) => {
setOpen(o);
if (!o) setI(0);
}}
>
{trigger && <Dialog.Trigger asChild>{trigger}</Dialog.Trigger>}
<Dialog.Portal>
<Dialog.Overlay
data-da={da}
className="fixed inset-0 z-50 bg-da-overlay backdrop-blur-[2px] transition-opacity duration-(--da-duration) starting:opacity-0 motion-reduce:transition-none"
/>
<Dialog.Content
data-da={da}
className="fixed top-1/2 left-1/2 z-50 w-[calc(100%-2rem)] max-w-md -translate-x-1/2 -translate-y-1/2 overflow-hidden rounded-da-lg bg-da-surface text-da-surface-fg shadow-da-lg outline-none transition-[opacity,scale] duration-(--da-duration-slow) ease-da-emphasized starting:scale-95 starting:opacity-0 motion-reduce:transition-none"
>
<div aria-hidden className={cn("grid h-44 place-items-center transition-colors duration-(--da-duration-slow)", TONE[s.tone])}>
<svg viewBox="0 0 100 100" className="h-28">
<ellipse cx="50" cy="92" rx="30" ry="4" fill="currentColor" opacity=".2" />
<path
d="M50 92V40"
stroke="currentColor"
strokeWidth="3"
strokeLinecap="round"
style={{
transform: `scaleY(${0.45 + i * 0.28})`,
transformOrigin: "50px 92px",
transition: "transform var(--da-duration-slow) var(--da-ease)",
}}
/>
<path d="M50 70c-14 0-22-8-22-22 14 0 22 8 22 22Z" fill="currentColor" opacity={i >= 0 ? 0.8 : 0} />
<path
d="M50 58c12 0 19-7 19-19-12 0-19 7-19 19Z"
fill="currentColor"
style={{ opacity: i >= 1 ? 1 : 0, transition: "opacity var(--da-duration-slow)" }}
/>
<circle cx="50" cy="30" r="7" fill="var(--da-secondary-fg)" style={{ opacity: i >= 2 ? 1 : 0, transition: "opacity var(--da-duration-slow)" }} />
</svg>
</div>
<div className="p-8">
<Dialog.Title className="font-da-display text-3xl">{s.title}</Dialog.Title>
<Dialog.Description className="mt-2 text-da-muted-fg">{s.text}</Dialog.Description>
<div className="mt-8 flex items-center justify-between gap-4">
<div className="flex gap-1.5" aria-label={`Step ${i + 1} of ${steps.length}`} role="img">
{steps.map((_, j) => (
<span
key={j}
className={cn("h-2.5 rounded-[60%_0] transition-all duration-(--da-duration)", j === i ? "w-6 bg-da-primary" : "w-2.5 bg-da-border-strong")}
/>
))}
</div>
<div className="flex gap-2">
{i > 0 && (
<button type="button" onClick={() => setI(i - 1)} className="da-focus h-11 rounded-da-pill px-4 font-medium hover:bg-da-surface-2">
Back
</button>
)}
<button
type="button"
onClick={() => {
if (last) {
onFinish?.();
setOpen(false);
setI(0);
} else setI(i + 1);
}}
className="da-focus h-11 rounded-da-pill bg-da-primary px-6 font-medium text-da-primary-fg hover:bg-da-primary/90"
>
{last ? "Let’s begin" : "Next"}
</button>
</div>
</div>
</div>
</Dialog.Content>
</Dialog.Portal>
</Dialog.Root>
);
}
export default WelcomeModal;
modules/organic-soft/ui/welcome-modal/index.tsx
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| trigger | ReactNode | — | Trigger. |
| defaultOpen | boolean | — | Default Open. |
| steps | WelcomeStep[] | — | Steps. |
| onFinish | () => void | — | Callback. |
| da | string | — | DA scope applied to portalled content. |
Other modal variants in Organic Soft
Bottom Sheet
Bottom sheet (Radix Dialog): slides up from the bottom with a grab handle and very rounded top corners; becomes a centered card from sm up.
Confirm Dialog
Gentle confirmation (Radix AlertDialog): a wilting-leaf illustration in a clay circle, serif question, kind consequence text, a sage “keep” action and a quiet clay confirm.
Modal
Soft dialog (Radix): large-radius cream card that rises gently with a slight overshoot, serif title, round close button and pill actions.
Modal in other art directions
Confirm Dialog
Destructive confirmation (Radix AlertDialog) over a hazard-striped overlay: red 'Danger zone' band, consequences list, and a type-the-name field that arms the delete button; async pending state.
Drawer
Side sheet (Radix Dialog) sliding in from the right or left in stepped motion: yellow title band with close square, scrollable body for forms, ruled footer actions.
Modal
Accessible dialog on Radix Dialog: colored title band (primary or danger), close button, scrollable body, footer action bar. Re-applies the DA scope inside the portal. Stepped drop-in entrance.
Onboarding Modal
Multi-step onboarding dialog: a colored visual panel (giant step number by default) next to title, description, segmented progress bar and Back/Next buttons; resets on open.
Bottom Sheet
Mobile-style bottom sheet (Radix Dialog): heavily frosted panel sliding up with a grab handle, title and description; becomes a floating centered card on wider screens.
Dropdown Menu
Frosted dropdown menu (Radix DropdownMenu) built from an items array: labels, icons, shortcuts, separators, checkbox items, nested submenus and a danger item.
Modal
Frosted glass sheet dialog (Radix): 40px backdrop blur, optional icon bubble, rise-and-pop entrance with overshoot, blurred overlay, round close button and footer actions.
Share Dialog
Glass share dialog: invite-by-email field with role select, people-with-access list, a general access switch (invited only / anyone with link) and a copy-link button with confirmation.
Command Palette
⌘K command palette (Radix Dialog): search input, results filtered as you type and grouped (actions, incidents, schedules), icons and shortcuts, arrow-key highlight, Enter to run, footer hints.
Modal
Radix-based dialog with fade + subtle scale entrance, optional icon, title/description, scrollable body and a tinted footer action bar. Re-applies the DA scope inside the portal.
Popover Card
Anchored popover (Radix Popover) with arrow, optional title + close button and any content — quick forms (snooze), definitions or details. Collision-aware placement.
Sheet
Side sheet (Radix Dialog) sliding in from the right or left over a dimmed overlay: title and description header with close button, scrollable body and footer actions.
Command Dialog
Command palette (Radix Dialog + listbox): a square panel near the top with a large borderless search, grouped results under mono headings, arrow-key navigation with an inverted active row and shortcut hints.
Drawer
Right side panel (Radix Dialog) sliding in over a dimmed page: mono top bar with label and “Close”, large title, scrollable body with ruled rows and a sticky footer.
Lightbox
Full-screen image viewer (Radix Dialog) on ink (stays dark in dark mode): the image frame centered, mono “03 / 04” counter and caption, Prev/Next text buttons and arrow-key navigation, thumbnails strip.
Modal
Square dialog (Radix): a mono label + text “Close” in the top bar, a full-ink rule, a large title, body and right-aligned actions; opens with a quick fade and 8px rise.
Confirm Dialog
Destructive confirmation (Radix AlertDialog): red warning icon, title, consequence text, optional “type VOID to confirm” guard, cancel + red confirm.
Modal
Corporate dialog (Radix): white card with header (title, description, close), divided scrollable body and a tinted footer bar for actions; quick fade + slight scale.
Payment Modal
Pay-invoice dialog: amount summary, card/bank method radio cards, method-specific fields, secure note and a pay button that switches to a success state.
Side Sheet
Detail drawer (Radix Dialog) sliding in from the right: full-height bordered panel with sticky header, scrollable body and footer actions — for record details.
Celebrate Modal
“Week complete!” celebration dialog: pastel confetti shapes burst from the center, trophy emoji, friendly copy, three pastel stat tiles and one pill button.
Confirm Sheet
Destructive confirmation shown as a bottom sheet on mobile and a centered card on desktop: big emoji in a red-tint circle, gentle copy, red confirm with pending state and a soft cancel.
Modal
Soft modal (Radix Dialog): big rounded white card popping in with a small bounce, pastel emoji circle, round close button, body and pill footer actions.
Popover Menu
Rounded dropdown menu (Radix DropdownMenu) with emoji items, keyboard hints, soft highlight, separators and a red danger item; pops in with a bounce.