# Alert

Contextual feedback with a title, explanation and a place to recover.

- Family: Status, imported from `mizu-ui` or `mizu-ui/status`
- Docs: https://mizu.user64bit.world/components/alert
- Source: https://github.com/0xuser64bit/mizu/blob/main/packages/mizu/src/status/Feedback.tsx

## Usage

```tsx
import { Alert } from "mizu-ui";

export function Example() {
  return (
    <Alert title="Your draft is safe" tone="success">
      Saved locally. Publish when you are ready.
    </Alert>
  );
}
```

## Copy it with the shadcn CLI

```sh
npx shadcn@latest init 0xuser64bit/mizu/preset # once, where there is no components.json
npx shadcn@latest add 0xuser64bit/mizu/alert
```

## Props

- `title`: `string`. Short feedback heading.
- `tone`: `StatusTone`. Feedback severity.
- `action`: `ReactNode`. Optional recovery control.

## Accessibility

Error messages use role=alert; other feedback uses role=status. Write specific recovery instructions.

## Motion

CSS transitions explain state changes. Reduced motion removes travel.