RoadieRoadie
  • Home
  • Brand
  • Foundations
  • Content
  • Tokens
  • Components
  • Charts
  • Widgets
  • Appearance
HomeBrandFoundations
Appearance

Foundations

  • Visual

    • Colors
    • Elevation
    • Iconography
    • Shape
    • Theming
  • Content

    • Date and time
    • Layout
    • Prose styles
    • Typography
  • Behaviour

    • Accessibility
    • Interactions
    • Motion
    • View transitions
  • Building apps

    • Forms
    • Linking
    • Navigation
    • Performance
    • Records modelAlpha
    • Tables

Shape

Docs updated
9 Oct 2026

ReferenceShape and layout tokens

Roadie uses Tailwind's built-in border-radius scale to create a consistent, rounded visual language that progresses from inline elements to full containers. Soft corners signal approachability.

Radius scale

The scale runs from inline marks to edge-to-edge hero surfaces. Roadie uses Tailwind's built-in radius utilities up to rounded-4xl and adds three extended tiers (rounded-5xl, rounded-6xl, and rounded-7xl) for large promotional layouts. Never use arbitrary values like rounded-[2.5rem]. Stick to the named utilities so the scale stays consistent.

On the docs site, each step of the scale is a tile with its class and value.

  • rounded-sm

    4px (0.25rem)

  • rounded-md

    6px (0.375rem)

  • rounded-lg

    8px (0.5rem)

  • rounded-xl

    12px (0.75rem)

  • rounded-2xl

    16px (1rem)

  • rounded-3xl

    24px (1.5rem)

  • rounded-4xl

    32px (2rem)

  • rounded-5xl

    40px (2.5rem)

  • rounded-6xl

    48px (3rem)

  • rounded-7xl

    56px (3.5rem)

  • rounded-full

    Fully round

TierClassUse for
Inlinerounded-smMarks, highlights
Smallrounded-mdInline code, code blocks, prose images
Fieldrounded-lgInputs, textareas, select triggers, radio items
Containerrounded-xlCards, select popups, radio cards, popovers
Largerounded-2xlModals, dialogs, Navigator panes
Panelrounded-3xlLarge raised panels
Sheetrounded-4xlDrawers, from any side
Herorounded-5xlHero cards, collection headers
Featurerounded-6xlFeature banners, spotlight surfaces
Oversizerounded-7xlEdge-to-edge promotional layouts
Fullrounded-fullButtons, badges, avatars, pills

Component usage

Which components use which tier. These are the defaults. Override with className when a specific context requires it.

ComponentTierClass
ButtonFullrounded-full
BadgeFullrounded-full
CardContainerrounded-xl
DialogLargerounded-2xl
DrawerSheetrounded-4xl
Select triggerFieldrounded-lg
Select popupContainerrounded-xl
InputFieldrounded-lg
TextareaFieldrounded-lg
RadioGroup (default)Fieldrounded-lg
RadioGroup (card)Containerrounded-xl
CodeSmallrounded-md
Mark and HighlightInlinerounded-sm
Prose (code blocks, images)Smallrounded-md

Guidelines

  • Prefer the standard tier for each element type. Override it with className only when a specific context demands it.
  • When in doubt, round up to the next tier for a softer feel. The brand leans soft.
  • Keep rounded-2xl for top-layer UI, such as modals and dialogs, and the Navigator's panes. Don't use it on inline components.
  • Never mix custom pixel values with the Tailwind scale. Stick to the utility classes.
  • Focus rings follow the radius by themselves. Roadie's is-interactive and is-interactive-field utilities handle focus ring radius, so no separate token is needed.

Match radius to hierarchy

Larger radii for higher-level containers, smaller radii for inline or nested elements. This creates a natural visual hierarchy.

Card uses rounded-xl

Do

Use larger radii for containers (cards and dialogs) and smaller radii for inline elements (code and marks).

Card uses rounded-md

Don’t

Don't apply the same radius everywhere. A card and an inline code span shouldn't share the same corner treatment.

Keep pills for actions

Reserve rounded-full for interactive pill shapes and circular elements.

BadgeTag

Do

Use rounded-full for buttons, badges, tags, and avatars.

A card with rounded-full

Don’t

Don't use rounded-full on cards or containers. Full rounding distorts rectangular layouts.

Nest with decreasing radius

When elements are nested, the inner element should use an equal or smaller radius than the outer. This avoids visual tension at corners.

Parent rounded-xl, child rounded-lg

Do

Inner elements use an equal or smaller radius than their parent.

Parent rounded-lg, child rounded-2xl

Don’t

Don't use a larger radius on a child than its parent. The child's corners clip awkwardly against the parent's straighter edges.

Previous page← IconographyNext pageTheming →