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

Primitives