Skip to content
flyingsalmon

flyingsalmon

An opinionated design system: bold, warm, and social, with flat surfaces, light only, orange throughout, and springy motion that stays out of the way. Every component installs into your own project with the shadcn CLI, so you own the code.

Getting started

  1. 1. Register the namespace. In a project with Tailwind CSS v4 and shadcn init already run, add the registry to components.json.

    {
      "registries": {
        "@flyingsalmon": "https://flyingsalmon.superbrian.dev/r/{name}.json"
      }
    }
  2. 2. Install the theme first. Every component reads its colour, radius, and motion tokens from it.

    npx shadcn@latest add @flyingsalmon/theme
  3. 3. Add components by name. Each component page shows its own command.

    npx shadcn@latest add @flyingsalmon/button @flyingsalmon/card

Foundations

  • Principles

    Bold, warm, flat, and where a result belongs.
  • Colours

    An orange brand over a beige page, palette steps only.
  • Typography

    Bricolage Grotesque announces; Onest does the work.
  • Spacing

    Tailwind’s 4px scale, one step for one job.
  • Radius

    One 12px base and the corner scale derived from it.
  • Motion

    Small, springy, and under 200ms.
  • Accessibility

    Visible focus, full keyboard paths, measured contrast.
  • Fields

    What every field shares: description, error, loading.

Components

Everything the registry ships. Pick one to see its examples, its guidelines, and how to use it from the keyboard.

Inputs

  • Button

    The action component. Six variants, four sizes, and a loading state that morphs the button around its own spinner while it stays focused and reachable.
  • Trip dates, November 2026

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30

    Calendar

    A month grid for picking a single date or a range. It draws the days and owns selection; the trigger, the panel, and the field wiring belong to date-picker.
  • Checkbox

    A tri-state checkbox that owns its label and error message. One 20px size; the check mark morphs into a dash for the indeterminate state.
  • Combobox

    A text field that opens a panel of the items the app supplies for the current text, taking one value or several as chips, with typed text allowed as a value. It owns its label and error like the rest of the field family; it never filters, fetches, or debounces.
  • 342026

    Date picker

    A field that opens a calendar in a panel and posts the chosen dates. It owns its label, error, and trigger like the rest of the field family; the grid inside is calendar.
  • Form

    A layout shell. It gives fields their vertical rhythm, an actions row, and an optional slot where the app places the submit result as an alert.
  • Input

    A single-line text field that owns its label, error message, and busyness. Text-like types only; stays editable while loading.
  • Number field

    A numeric field with a unit, bounds, and a step. It owns its label and error like the rest of the field family.
  • Room

    Radio group

    A single choice from a small set of visible options, in one 20px size. It owns its label and error message like the rest of the field family; the checked item fills primary with a knocked-out dot that fades in.
  • Select

    A single-select field that owns its label and error message. The list is a modal surface anchored to the trigger.
  • Pace

    Two plans a day

    Slider

    A stepped track that picks one value: a dot for every step, a fill to the thumb, and the current step described below the track. The description is also what a screen reader announces.
  • Switch

    An instant-apply on/off control that owns its label and its own busyness. Two sizes on the field family's heights, so it lines up in a row of fields; no variants, no error state; a failed toggle is a result the app shows.
  • Textarea

    A multiline text field that owns its label, error message, and busyness. Autosizes between a row floor and a row cap; stays editable while loading.
  • Pace

    Toggle group

    A set of chips that toggle in single or multiple mode, wrapping across rows. Single mode returns to empty, multiple mode takes a max, and required blocks the last deselect. No shared track and no tab shape: each chip is its own control.

Data display

  • BNLT

    Avatar

    The identity mark for a person. Image, then two initials on one of six group hues, then a plain circle. Static and non-focusable.
  • Avatar group

    An overlapping row of avatars with an overflow count past a limit. Hover or keyboard focus parts the row around one avatar until it stands free and reveals its name; the chip reveals the names it hides.
  • DefaultSuccessOutline

    Badge

    A static marker for a status, a category, or a small count. Six variants, one size, never focusable and never animated.
  • Flights
    Hotels

    Separator

    A one-pixel rule that divides content, horizontal or vertical. Decorative by default, announced only when the division carries meaning.
  • Sticker

    Hand-drawn art as a die-cut sticker: role-named paths coloured by theme classes, a cut edge around the drawing, lines that boil, and a pop-in as it scrolls into view. Ships the rough.js drawing script that makes the art.
  • StopNights
    Kyoto3
    Tokyo4

    Table

    A styled primitive for tabular data in seven parts: Table, TableHeader, TableBody, TableFooter, TableRow, TableHeadCell, and TableCell. Horizontal rules only, a primary header rule, a background step on the hovered body row, and an interactive row whose single link stretches over the whole row. Sorting, selection, and pagination belong to a data table built on top.

    Timeline

    A sequence of markers joined by a connector. Content sits beside its marker; meaning stays with the consumer.

Feedback

  • Trip saved

    Alert

    The app's inline vehicle for the result of an action. A neutral surface where the icon carries the variant, two sizes, an optional close button, and its own enter and exit animation.
  • No trips yet

    Empty state

    A resting no-content block: optional sticker or icon art, a required title, an optional description, and one or two actions. Two sizes, no variants, and no border or background of its own.
  • Error state

    An empty state for content that failed to arrive: the same art, title, description, and actions, announced as an alert named by its title, with its sticker tilted the other way.
  • Link copied
    View the trip

    Notice

    One persistent message for a result with no visible home, dismissed by the user and never by a timer. It links back to its subject and never takes focus.
  • Progress

    A bar for an operation of known length, determinate or indeterminate. Spinner covers an action's busyness and skeleton covers a loading region; progress covers measured work.
  • Skeleton

    The region-loading placeholder. Three shape presets sized by the consumer, pulsing on a 2s cycle, always hidden from assistive technology.
  • Spinner

    The loading primitive for action busyness. One variant, two sizes, a currentColor arc rotating once per 800ms.

Surfaces & floating components

  • Accordion

    Progressive disclosure in a divider list: a heading row opens its own panel on a height animation. Several items open at once by default; type single with collapsible gives a one-item disclosure.
  • Weekend in Kyoto

    Three days, ten stops

    Card

    A flat container that groups related content on one surface. Seven slots, one padding step, no variants; `interactive` opts into hover, press, and focus feedback through a stretched title link.
  • Dialog

    A modal surface over a scrim. It traps focus, locks scroll, and returns focus to its trigger on close.
  • Drawer

    A modal panel inset at the right edge of the viewport for secondary content that accompanies the page still visible beside it: filters for a list, the detail of a selected row. It is dialog's root and parts with one panel of its own, and it is never app navigation and never a confirm.
  • Dropdown menu

    A modal menu of actions anchored to its trigger. Arrow keys walk the items; choosing one closes the menu.
  • Day 1

    Icon tooltip

    A focusable icon named by its tooltip text. Keyboard focus and hover open the tooltip, and the icon stays reachable inside a row whose whole surface is a link.
  • Tooltip

    A non-modal label anchored to its trigger. It never takes focus, and pointer leave, blur, or Escape dismisses it.

Navigation

  • Breadcrumb

    A trail showing where the current page sits in a hierarchy. Every level above the current one links back up; the current page is plain text.
  • Trips

    Page header

    A page's title and the actions that act on the whole page, nothing else. One display-size h1, and an actions group that shares the title's row on a wide header and wraps under it on a narrow one.
  • Pagination

    One controlled control that moves between the numbered pages of a list or table: previous, a seven-slot window of page numbers with an ellipsis for every run of at least two hidden pages, and next. A compact form reads "Page 3 of 12" instead. Page size and the range line stay with the app.
  • TC

    Sidebar

    An aside with header, content, and footer slots that morphs between an expanded column and an icon rail, and becomes one sticky horizontal strip under a 700px viewport, where its content moves into a menu the trigger opens. It hosts navigation items or any other rail content.
  • Stepper

    A bar of equal segments filled through the current one, for a position in a sequence of known count. It reads as ticks rather than a fraction; progress covers one operation of known length.
  • Trip summary and highlights.

    Tabs

    A horizontal tab set in one underline variant. A sliding indicator tracks the selected tab; a separate bar marks focus.
  • Text link

    An anchor for a sentence or a line of UI copy. It takes its size and weight from the text around it and carries an underline that never leaves; a link navigates and a button acts.