Design system
Forms
Field wraps a label, a control, help text and errors. Two columns from small screens up.
Search and pickers
Search filters a list in place. A combobox picks one record from many.
Which message goes where
One channel per situation. Titles say what happened in the words of the button that caused it: Record payment, then Payment recorded.
| When | Show | Use |
|---|---|---|
| An action worked | Toast | notify.success, or redirectWithToast when the action redirects |
| An action worked and can be reversed | Toast with Undo | notify.undo |
| An action failed for a reason no field can fix | Toast | notify.error |
| A form was rejected | Alert above the form, error under each field | Alert and FieldError. Never a toast: it is gone before the fix. |
| Something on this page needs attention | Alert, in place, until it is resolved | Alert |
| An action cannot be undone | Dialog, before it happens | ConfirmDialog |
| Work that takes more than a moment | Toast that updates when it finishes | notify.progress |
| There is nothing to show | Empty state with the next step | Empty |
Toasts
Success stays 4 seconds, errors and Undo stay 8. The last button saves on the server and redirects, and the toast follows.
Alerts
Inline and persistent. Color marks the state; text stays in ink.
Status badges
One tone per meaning, with a dot so status is not carried by color alone.
Progress and loading
Meters for known progress, spinners for short waits, skeletons for content still loading.
Program minimum is 85%.
Empty state
Overlays
Dialogs for focused tasks, sheets for a quick look at a record, popovers for small extras.
In-page navigation
Tabs switch views inside one page. Toggle groups switch how the same data is shown.
Keyboard hints use ⌘ K.