# Form Rating Input

Star rating input with half stars and keyboard support.

- id: `form-rating-input`
- Page: https://agentic-ui-kit.com/components/form-rating-input
- Live preview: https://agentic-ui-kit.com/live/component/form-rating-input?piece=form-rating-input

## Install

```bash
agentic-ui add form-rating-input
npx shadcn@4.17.0 add @agentic-ui/form-rating-input
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** star-rating, half-steps, custom-icon, radiogroup-keyboard, hover-preview, read-only, clearable, form-field, dark-mode
- **Intents:** create-edit, communicate
- **Suits domains:** ecommerce, saas, support, education, culinary, travel
- **Interaction:** click, hover, keyboard-navigation, clearable
- **Screen role:** flow
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** star rating input with half stars and keyboard support, review form field to rate a product from 1 to 5 stars, read-only star rating that shows an average, rating with a custom heart icon that can be cleared
- **Avoid when:** a summary of many ratings with a histogram (use marketing-rating-summary), a 0 to 10 scale such as NPS, where a numeric scale fits better, a continuous value, where a slider is the right control
- **Preserve when adapting:** radiogroup-semantics, half-step-model, read-only-image
- **Replace when adapting:** icon, max, unit-word, label
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives