Unify Applications
Logo
Borders & Radius

Borders & Radius

Logo

3 mins READ

Overview

The Border tab of the theme editor controls how rounded your app's corners are. To open it, go to Settings → Design System → Theme Builder in the app builder and select the Border tab. It is a single global preset, not a per-block setting: pick the shape language once and the whole app follows it. Buttons, inputs, cards, modals, tags — all their corners resolve to the values your preset defines.

borders_and_radius.png
borders_and_radius.png

The Four Presets

Presets are shown in order from squarest to roundest.

PresetDescription
Fully SquareNo rounding — sharp, square corners on all elements. Every radius token collapses to 0.
Soft SquareSlightly rounded corners for a subtle touch. Most steps stay at a subtle 4px.
RoundedModerately rounded corners for a balanced, contemporary appearance. Radii spread from 2px up to 12px.
Fully RoundedFully rounded corners for a smooth, pill-like shape. Small elements turn pill-shaped. Also widens buttons slightly (see Gotchas).

Selecting a preset applies immediately to the theme preview. Click Save in the Theme Builder to make the change permanent, or Cancel to discard it.

How It Works

Behind each preset sits a full ladder of corner-radius sizes, from "none" up to the largest card rounding, plus a "full" pill value. Blocks don't hardcode their rounding — a small chip asks for a small radius step, a card asks for a large one — and the preset decides what each step is worth.

  • Fully Square — collapses every step to zero

  • Soft Square — keeps most steps at a subtle value

  • Rounded — spreads them from small to medium

  • Fully Rounded — pushes them large enough that small elements turn pill-shaped

One selection restyles all corners consistently, each element at a size appropriate to it.

Radius Token Reference

All values are in rem. --radius-full is 9999rem in every preset — a value large enough to make any corner fully round, giving a pill shape.

TokenFully SquareSoft SquareRoundedFully Rounded
--radius-none0000
--radius-xxs00.1250.1250.375
--radius-xs00.250.250.75
--radius-sm00.250.3750.75
--radius-md00.250.50.75
--radius-lg00.250.50.75
--radius-xl00.250.50.75
--radius-2xl00.250.51.25
--radius-3xl00.6250.6251.25
--radius-4xl00.750.751.25
--radius-full9999999999999999

Component-Specific Radius Tokens

The preset also writes component-specific tokens, some only under Fully Rounded:

TokenApplied UnderNotes
--button-radiusAll four presetsOne value per button size (xs, sm, md, lg)
--button-padding-xFully Rounded onlyWidens xs and sm buttons so the pill doesn't pinch labels
--input-radiusAll four presetsOne value per input size (sm, md)
--input-padding-xFully Rounded onlyApplied to both input sizes
--checkbox-radiusFully Rounded onlyKeeps checkboxes from turning into circles
--ua-listitem-padding-xFully Rounded onlyOne value per list-item size (sm, md)
--tooltip-radiusFully Rounded onlyHolds tooltips back to the Rounded value
--variable-data-pill-radiusAll four presets—
--chart-bar-radiusAll four presetsRounds the ends of chart bars

Overriding Radius for a Single Element

There is no per-preset fine-tuning in the Border tab. Radius tokens are theme-wide, so overriding one changes every element that uses that step, in every app on the theme.

  • To change one step of the scale everywhere: open the Tokens & CSS tab of the theme editor and override the specific --radius-* token in your scoped CSS block.

  • To round a single element differently: use that block's own Appearance corner radius setting. It overrides the theme preset for that block instance only.

Trade-offs & Gotchas

  • It's one global choice. The border preset is stored as a single value on the theme. There is no way to give one page square corners and another page rounded corners from this tab alone.

  • Fully Rounded also widens buttons. The preset doesn't only change radii — Fully Rounded additionally increases the horizontal padding of buttons so the pill shape doesn't pinch their labels. Expect buttons to be slightly wider under Fully Rounded than under the other three presets.

  • Overriding a token changes that step everywhere. A --radius-* override in Tokens & CSS applies to every element that uses that step, across every app on the theme. For a one-off exception on a single element, use the block's Appearance corner radius instead.