Upgrading to 1.0
⋯
@nesra/ui 1.0 follows the Figma design system as updated from 28 October 2026 (DES-269 / ENG-968).
Most of the work landed in 0.x releases as additions. 1.0 removes the token names that 0.x kept as
deprecated aliases. If your app builds without the names below, the upgrade needs no code changes.
1. Replace removed tokens
Section titled “1. Replace removed tokens”Search your code for each removed name, in both its CSS variable form (--nesra-text-muted) and its
Tailwind utility form (text-nesra-text-muted, bg-nesra-…, border-nesra-…).
Renamed in Figma
Section titled “Renamed in Figma”| Removed | Use instead |
|---|---|
--nesra-text-muted |
--nesra-text-support |
--nesra-text-brand-secondary |
--nesra-text-secondary |
--nesra-stroke-border-subtle |
--nesra-stroke-border-strong |
--nesra-shadow-skeumorphic-inner |
--nesra-shadow-skeuomorphic-inner |
--nesra-shadow-skeumorphic-inner-border |
--nesra-shadow-skeuomorphic-inner-border |
--nesra-background-overlay |
--nesra-foundation-bg-overlay |
--nesra-background-brand-solid |
--nesra-foundation-bg-brand-solid |
Deleted in Figma
Section titled “Deleted in Figma”| Removed | Use instead |
|---|---|
--nesra-surface-card-bg-brand-primary |
--nesra-foundation-bg-brand-primary; tooltips use --nesra-foundation-bg-inverse |
--nesra-action-secondary-disabled |
--nesra-foundation-bg-disabled |
--nesra-action-primary-static-white |
--nesra-text-on-brand on brand surfaces, otherwise --nesra-text-static-white |
--nesra-text-warning |
--nesra-categorical-yellow-foreground. The old yellow-500 text was 1.9:1 on white |
--nesra-component-avatar-bg-neutral |
--nesra-foundation-bg-neutral |
--nesra-component-avatar-border |
--nesra-stroke-border |
--nesra-calendar-imported-component-colors-alpha-black-100 |
--nesra-black |
--nesra-calendar-size-date-icon-height |
--nesra-unit-27 (56px), as h-nesra-unit-27 |
Badge tokens
Section titled “Badge tokens”The code-only --nesra-badge-* tokens are gone. Badge now binds the Figma roles directly. If you
used these tokens outside Badge, use the role Badge uses for the same color.
| Removed | Use instead |
|---|---|
badge-brand-soft, badge-brand-foreground |
foundation-bg-brand-primary-50, text-body |
badge-brand-fill |
foundation-bg-brand-primary, with text-on-brand on top |
badge-info-soft, badge-info-foreground |
categorical-blue-subtle, text-link |
badge-info-fill |
foundation-bg-info-solid, with text-static-white on top |
badge-success-soft, badge-success-foreground |
categorical-green-subtle, categorical-green-foreground |
badge-success-fill |
foundation-bg-success-solid, with text-static-white on top |
badge-warning-soft, badge-warning-foreground |
categorical-yellow-subtle, categorical-yellow-foreground |
badge-warning-fill, badge-warning-fill-foreground |
categorical-yellow-base, text-static-dark |
badge-error-soft, badge-error-foreground |
categorical-red-subtle, categorical-red-foreground |
badge-error-fill |
action-destructive-default, with text-static-white on top |
badge-neutral-soft, badge-neutral-foreground |
foundation-bg-gray, text-body |
badge-neutral-fill |
categorical-neutral-base, with text-static-white on top |
2. Pick roles by the surface they sit on
Section titled “2. Pick roles by the surface they sit on”Light and Dark use the same role names with different values. A pairing that looks right in Light can disappear in Dark, so choose the content role from the surface:
- On
foundation-bg-brand-primaryand the primary button, usetext-on-brandandicon-on-brand. This surface turns light in Dark. - On
foundation-bg-inverse, as in tooltips, usetext-inverse,icon-inverseandstroke-inverse. - Use
text-static-whiteonly on fixed dark or saturated fills and on photos. Usetext-static-darkon fixed light fills such as yellow. - In disabled states, use
text-disabled,icon-disabledandfoundation-bg-disabled.
Do not patch a mode with dark: variants or raw palette values.
3. Turn on Dark mode, if you want it
Section titled “3. Turn on Dark mode, if you want it”Light stays the default. Add dark as a class, or data-theme="dark", to <html> or to any
container. Use light, or data-theme="light", to switch a subtree back. Your app owns the switch
and any saved preference. Nesra UI does not follow prefers-color-scheme on its own. See
Colors.
4. Expect these visual changes
Section titled “4. Expect these visual changes”These changes follow Figma. They shipped in 0.x minors and are listed here for teams that upgrade across several versions at once.
- Focus.
- Focus rings are a visible gray-600, where they used to be near-white gray-200.
- Filled buttons and tabs use the two-layer
shadow-nesra-focus-ring-offset. - Fields in an error state show
shadow-nesra-destructive.
- Status colors.
- Destructive fills are red-600 and hover red-700.
- Destructive text is red-600.
- Success text is green-700. Success and warning icons and strokes are darker.
- Disabled. Text and icons are gray-400.
- Ghost buttons.
action-tertiary-defaultis transparent, no longer white. - Tooltips. Basic tooltips and chart tooltips are inverse: dark in Light, light in Dark.
- Shadows. Box shadows take their color from the
Shadow/*roles, and are twice as strong in Dark.
These changes are new in 1.0.0:
- Sidebar rows.
Sidebar.MenuButton,Sidebar.MenuSubButton, andSidebar.MenuSkeletondefault tosize="compact", Figma’s 28px nav item with 12px labels and 16px icons. To keep the 0.x rows, setsize="default"on menu buttons and skeletons andsize="md"on sub buttons. - Tabs.
pilltriggers are 36px tall atmd(were 38px), use Medium labels, and have 14px and 16px side padding. Horizontallinetriggers keep the label at the top with 4px side padding and 12px between triggers. - Sidebar toggle.
Sidebar.Triggeris Figma’s 28px toggle with a tooltip. - Charts. Charts no longer show a “View data” disclosure. Their data table stays in the page for
screen readers, visually hidden.
ComboCharthover draws the dashed center line above the bars, in place of the shaded category. Line, Area, Bar, and Combo acceptxAxisLabelandyAxisLabelfor the axis legend. - Smaller details. The Calendar view menu trigger uses
stroke-border-strong. The Message status tooltip usesshadow-nesra-lgand Body/XSmall Semibold.