# Bell Button

A subscribe toggle with a bell that swings on two coupled springs.

Tier: Free

## Installation

```bash
npx shadcn add @fetaui/bell-button
```

## Usage

```tsx
import { BellButton } from '@/components/fetaui/bell-button'

export function Example() {
  return <BellButton variant="default" onPressedChange={setSubscribed} />
}
```

## API

| Prop | Type | Default |
|---|---|---|
| variant | default, compact, icon | default |
| pressed | boolean |  |
| defaultPressed | boolean | false |
| onPressedChange | (pressed) => void |  |
| label | string | Subscribe |
| pressedLabel | string | Subscribed |
| disabled | boolean | false |
| animated | boolean | true |

## When to use

- For subscribing to updates.

## When not to use

- For general settings: use Switch.

## Accessibility

- A native button with aria-pressed.

## Motion

- Turning on tilts the bell −12° and swings it back on two springs.
- With reduced motion, the bell does not swing.
- Swift uses one spring.