Files
backstage/packages/ui
Charles de Dreuille 657aad6cf0 refactor(ui): rename surface tokens to neutral background tokens
Replace --bui-surface-1..5 with --bui-bg-neutral-1..5 for both light
and dark themes. --bui-bg-neutral-1 replaces the deprecated --bui-bg-app,
and --bui-bg-neutral-2..5 extend the scale. The old bare --bui-bg-neutral-1..4
entries are removed from the deprecated section since their names are now
reused; the hover/pressed/disabled variants remain deprecated.

Updates colors.stories.tsx, the ESLint rule and tests, and all migration
documentation and the PR description accordingly.

Signed-off-by: Charles de Dreuille <charles.dedreuille@gmail.com>
2026-05-27 13:11:38 +02:00
..
2026-02-03 15:08:27 +01:00
2026-05-19 18:28:24 +00:00
2026-04-16 12:14:47 +02:00
2026-05-19 18:28:24 +00:00

@backstage/ui

Backstage UI is a component library for Backstage.

Installation

Install the package via Yarn:

cd <package-dir> # if within a monorepo
yarn add @backstage/ui

Documentation

Writing Changesets for Components

When creating changesets for component-specific changes, add component metadata to help maintain documentation:

---
'@backstage/ui': patch
---

Fixed size prop handling for Avatar component.

Affected components: Avatar

Guidelines:

  • Component names: Use PascalCase as they appear in imports (Avatar, ButtonIcon, SearchField)
  • Multiple components: Affected components: Button, ButtonLink, ButtonIcon
  • General changes: Omit the metadata line (build changes, package-level updates)
  • Placement: The line can appear anywhere in the description

The changelog sync tool will parse these tags and update the documentation site automatically.