For AI agents: the documentation index is at /llms.txt, and any docs page is available as Markdown by appending .md to its URL.

Rating

Verified

A star rating built as a radio group, or a read-only display of an average.

When to use

Use when: Collecting or showing a star rating.
Avoid when: A value on a wide scale; use Slider.

Installation

bunx shelf add rating

The source lands in src/components/ui/rating.tsx, along with any Shelf items it builds on, and .shelf/lock.json records what was installed. It's yours to edit.

Usage

import { Rating } from "@/components/ui/rating";

<Rating aria-label="Rate this answer" onValueChange={save} />

Built on

Packages: @base-ui/react, @stylexjs/stylex
Shelf items: foundations, Icons, utils
Accessibility: Focus, keyboard, and ARIA behavior come from Base UI.
Figma: Optional native Figma library. See Designers.

Verified

Size: 1.1 kB gzipped on its own, 14 kB with the Shelf items and packages it builds on. JS and CSS in a production build, without React.
Accessibility: Axe passes on 4 stories
Behavior: 4 interaction tests in Storybook
React Compiler: Compiles with React Compiler
React Doctor: React Doctor finds nothing