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