Components
Start with a pattern for the frame, content blocks for the body, and primitives for individual controls.
Patterns
- Drawer
A record or a content-heavy flow opened from a page: header, optional pinned region, a body that scrolls, one footer band.
- Copy the bindings from
- app/
features/ website/ routes/ dashboard/ settings.locations/ components/ edit-location-drawer.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ settings/ locations
- Modal
A small detail view or a single action over the page: header, a body that scrolls, one tinted footer band. A confirmation is ConfirmModal.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ forms/ components/ duplicate-form-modal.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ forms
- Wizard
Creating something in steps: the modal shell with a step bar, a fixed-height step area, Cancel on the first step and Back after, on the left, and the primary on the right.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ submitted-forms.kind/ components/ new-application-wizard.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind
- List page
Managing a set of records: the header with its actions, then the search, filter pills, Sort, and count line, then the rows.
- Copy the bindings from
- app/
features/ animals/ routes/ dashboard/ animal-list.group/ components/ animal-list-filters.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ animal-list/ :group
- Selection bar
Choosing several rows for one bulk action: the bar docked at the bottom with the count, Select all, Clear, Cancel, and the primary.
- Copy the bindings from
- app/
features/ animals/ routes/ dashboard/ animal-list.group/ components/ bulk-selection-bar.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ animal-list/ :group
- Empty states
A collection with nothing in it yet, and a search or filter that matched nothing.
- Copy the bindings from
- app/
features/ website/ routes/ dashboard/ settings.locations/ settings.locations.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ settings/ locations
- Section headings
The uppercase label that starts a section of a drawer or a step, or labels a group of values.
- Copy the bindings from
- app/
features/ fundraisers/ routes/ dashboard/ fundraisers.slug.edit/ components/ share-messages-drawer-body.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ fundraisers/ :slug/ edit
- Tabs
Sections of a record or a page, as buttons that switch in place or links that navigate, with count pills.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ submitted-forms.kind/ components/ review-drawer.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind?review=:id
Content blocks
- Compact documents
Files and a drop zone inside an overlay, with field and section labels.
- Copy the bindings from
- app/
features/ contracts/ routes/ dashboard/ contracts.checkout-preview/ components/ document-files-section.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind
- Page documents
Uploads and existing files aligned with the page’s form sections.
- Copy the bindings from
- app/
features/ contracts/ routes/ dashboard/ contracts.id/ contracts.id.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ contracts/ :id
- Image grid
Ordered photo thumbnails with uploading, removal, and empty states.
- Copy the bindings from
- app/
features/ animals/ routes/ dashboard/ animals.group.id.edit/ components/ animal-images-section.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ animals/ :group/ :id/ edit
- Selectable catalog
Search existing items, select them, edit or create an item, and see a subtotal.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ submitted-forms.kind/ components/ invoice-items-row.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind
- Selectable roles
Choose roles with their badges, descriptions, counts, and disabled reasons.
- Copy the bindings from
- app/
features/ people/ components/ wizard-steps.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ volunteers/ pending
- Chosen items
Already chosen records with identity, facts, and a remove action.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ submitted-forms.kind/ components/ new-application-details-step.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind
- Read-only people
Bordered recipient rows with identifying facts, count, and search.
- Copy the bindings from
- app/
features/ contracts/ routes/ dashboard/ contracts.checkout-preview/ components/ notification-section.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ contracts/ checkout-preview
- Editable membership
People with add and remove controls, empty state, and search.
- Copy the bindings from
- app/
features/ people/ routes/ volunteers.settings.roles.roleId/ components/ role-holders-rail.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ volunteers/ settings/ roles/ :roleId
- Review summary
A bordered label and value summary for a review step. On a phone values wrap under their labels, left-aligned.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ submitted-forms.kind/ components/ new-application-review-step.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind
- Facts grid
A record’s at-a-glance facts with small labels above wrapping values.
- Copy the bindings from
- app/
features/ people/ routes/ volunteers/ components/ person-drawer.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ volunteers?person=:id
- Bento card
A titled card in a grid. Only a card that opens something lifts on hover.
- Copy the bindings from
- app/
features/ payments/ routes/ dashboard/ payments/ components/ account-facts-grid.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ payments
- Configuration rows
Editable sending options with popovers, current values, and warnings.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ submitted-forms.kind/ components/ send-contract-drawer.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind
- Money breakdown
Line items, fees, discounts, and totals for a summary or receipt.
- Copy the bindings from
- app/
features/ fundraisers/ routes/ public/ fundraisers.slug.checkout/ components/ details-summary-panel.tsx - Route
- /
fundraisers/ :slug/ checkout
- Grouped checklist
Selectable field groups with facts, disabled reasons, count, and search.
- Copy the bindings from
- app/
features/ animals/ routes/ dashboard/ animal-list.group/ components/ bulk-group-list.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ animal-list/ :group
- Editable rows
Repeated fields with add and remove actions, numbering, and single-amount mode.
- Copy the bindings from
- app/
features/ payments/ routes/ dashboard/ adoption-fees.typeId/ components/ rule-form.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ adoption-fees/ :typeId
- Default form mappings
Compact rows for configured animal types and their form selectors.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ forms.settings/ components/ default-forms-list.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ forms/ settings
- Signing queue
Ordered contracts with add, remove, reorder, hints, and preview.
- Copy the bindings from
- app/
features/ forms/ routes/ dashboard/ submitted-forms.kind/ components/ send-queue-eyebrow-section.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ submitted-forms/ :kind
- Notes and composer
Gray note cards and a composer opened from Add note.
- Copy the bindings from
- app/
features/ people/ routes/ volunteers/ components/ person-drawer.tsx - Route
- /
dashboard/ accounts/ :acctId/ sites/ :siteId/ volunteers?person=:id