# @backstage/ui

Latest version **0.18.0** (published 2026-09-15) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @backstage/ui
pnpm add @backstage/ui
yarn add @backstage/ui
bun add @backstage/ui
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.18.0 |
| Published | 2026-09-15 |
| First published | 2025-07-15 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 11 |
| Unpacked size | 1.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 34428 |
| Maintainers | patriko, freben, marcuseide |
| Keywords | backstage |

## Links

- npm: https://www.npmjs.com/package/@backstage/ui
- Repository: https://github.com/backstage/backstage
- Homepage: https://ui.backstage.io
- npm.io page: https://npm.io/package/@backstage/ui

## Dependencies (11)

- [clsx](https://npm.io/package/clsx.md) ^2.1.1
- [marked](https://npm.io/package/marked.md) ^15.0.12
- [react-aria](https://npm.io/package/react-aria.md) ~3.48.0
- [react-stately](https://npm.io/package/react-stately.md) ~3.46.0
- [@remixicon/react](https://npm.io/package/@remixicon/react.md) >=4.6.0 <4.9.0
- [@tanstack/react-table](https://npm.io/package/@tanstack/react-table.md) ^8.21.3
- [react-aria-components](https://npm.io/package/react-aria-components.md) ~1.17.0
- [@braintree/sanitize-url](https://npm.io/package/@braintree/sanitize-url.md) ^7.1.2
- [@internationalized/date](https://npm.io/package/@internationalized/date.md) ^3.12.0
- [use-sync-external-store](https://npm.io/package/use-sync-external-store.md) ^1.4.0
- [@backstage/version-bridge](https://npm.io/package/@backstage/version-bridge.md) ^1.0.12

## Recent versions

- 0.18.0 (latest) — 2026-09-15
- 0.0.0-nightly-20260909022715 (nightly) — 2026-09-09
- 0.18.0-next.2 (next) — 2026-09-08
- 0.0.0-nightly-20260904022803 — 2026-09-04
- 0.0.0-nightly-20260902024315 — 2026-09-02
- 0.18.0-next.1 — 2026-09-01
- 0.0.0-nightly-20260829022506 — 2026-08-29
- 0.0.0-nightly-20260828045505 — 2026-08-28
- 0.0.0-nightly-20260827035829 — 2026-08-27
- 0.0.0-nightly-20260826023806 — 2026-08-26
- 0.17.2-next.0 — 2026-08-25
- 0.0.0-nightly-20260825023435 — 2026-08-25
- 0.0.0-nightly-20260824023732 — 2026-08-24
- 0.0.0-nightly-20260823023807 — 2026-08-23
- 0.0.0-nightly-20260822023239 — 2026-08-22
- … 378 more at https://npm.io/package/@backstage/ui/versions

## README

# @backstage/ui

Backstage UI is a component library for Backstage.

## Installation

Install the package via Yarn:

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

## Documentation

- [Backstage UI Documentation](https://ui.backstage.io)
- [Backstage Readme](https://github.com/backstage/backstage/blob/master/README.md)
- [Backstage Documentation](https://backstage.io/docs)

## Writing Changesets for Components

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

```markdown
---
'@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.

---
_Source: https://npm.io/package/@backstage/ui · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._