Skip to content
Design System
GitHub

Radius

Six steps, 4 to 24, each 4 px apart, sharing the spacing base. Because steps differ by the padding between them, nested corners can always be concentric. npm run check:radius (run locally, with the site running) finds corners that are not, on the home page, the foundation pages, every component page and every block preview.

Scale

rounded-2xs4Controls 24 px and smaller: checkbox, key caps, a handle in a tight row
rounded-xs8Tags, small parts, items inside a panel with 8 px padding (menus, command)
rounded-sm12Buttons, inputs, icon tiles
rounded-md16Cards, parts inside a tray
rounded-lg20Floating notices, dialogs
rounded-xl24Trays (island, dock), bottom sheets

Outer radius = inner radius + padding

A tray (24) with 8 padding holds parts at 16. A panel (16) with 8 padding holds items at 8, never at 12: a menu, the command list, a row of attachments. When the parts must stay at 12, give the container 20. The curves stay parallel.

24 = 16 + 8
Do. Step the radius down by the padding you add.
24 inside 24
Don't. Repeat the outer radius inside. The gap pinches at the corners and the shapes look misaligned.

Full: only for things that are round

rounded-full is not a seventh step. Round by nature: avatars, dots and bullets, switch and radio, tracks and thumbs (slider, progress, meter, scrollbar), count badges, step circles, grips and grabbers. Never a container, card or button.

  • Avatars and their placeholders
  • Dots and bullets: status dots, event dots, list bullets
  • Switch and radio: the switch track and thumb, the radio and its dot
  • Tracks and thumbs: slider, progress, meter, scrollbar
  • Count badges (a number in a circle)
  • Step circles
  • Grips and grabbers: the bottom sheet's grabber, a resize grip
Start patrol
Do. Buttons use rounded-sm.
Start patrol
Don't. A pill button is a second shape language.

CI enforces it: npm run lint:tokens fails on rounded-full in any file not listed with its use (ROUND in scripts/check-tokens.mjs).

Brand mark and icon tiles

The SYNCROBOTIC mark is a disc by design. It is artwork, not UI, so the radius scale does not reshape it. What holds the mark follows the scale.

Mark: never re-cornered
Favicon tile: corner 22 % of the side

App icons that the OS masks (iOS, Android adaptive) are drawn full bleed: the OS supplies the tile, and a second radius inside it would not be concentric.

Tokens

shadcn defaults differ: its button and input use rounded-md, its card rounded-xl. Move them to the steps above when adding them to the registry.

  • --radius-2xs
    Utility
    rounded-2xs
    px
    4
    Use
    Controls 24 px and smaller: checkbox, key caps, a handle in a tight row
  • --radius-xs
    Utility
    rounded-xs
    px
    8
    Use
    Tags, small parts, items inside a panel with 8 px padding (menus, command)
  • --radius-sm
    Utility
    rounded-sm
    px
    12
    Use
    Buttons, inputs, icon tiles
  • --radius-md
    Utility
    rounded-md
    px
    16
    Use
    Cards, parts inside a tray
  • --radius-lg
    Utility
    rounded-lg
    px
    20
    Use
    Floating notices, dialogs
  • --radius-xl
    Utility
    rounded-xl
    px
    24
    Use
    Trays (island, dock), bottom sheets