Skip to content

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.

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-…).

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
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

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

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-primary and the primary button, use text-on-brand and icon-on-brand. This surface turns light in Dark.
  • On foundation-bg-inverse, as in tooltips, use text-inverse, icon-inverse and stroke-inverse.
  • Use text-static-white only on fixed dark or saturated fills and on photos. Use text-static-dark on fixed light fills such as yellow.
  • In disabled states, use text-disabled, icon-disabled and foundation-bg-disabled.

Do not patch a mode with dark: variants or raw palette values.

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.

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-default is 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, and Sidebar.MenuSkeleton default to size="compact", Figma’s 28px nav item with 12px labels and 16px icons. To keep the 0.x rows, set size="default" on menu buttons and skeletons and size="md" on sub buttons.
  • Tabs. pill triggers are 36px tall at md (were 38px), use Medium labels, and have 14px and 16px side padding. Horizontal line triggers keep the label at the top with 4px side padding and 12px between triggers.
  • Sidebar toggle. Sidebar.Trigger is 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. ComboChart hover draws the dashed center line above the bars, in place of the shaded category. Line, Area, Bar, and Combo accept xAxisLabel and yAxisLabel for the axis legend.
  • Smaller details. The Calendar view menu trigger uses stroke-border-strong. The Message status tooltip uses shadow-nesra-lg and Body/XSmall Semibold.