# Motion Shake Error

Password field that shakes once after a wrong-password sign-in, with an error border, an alert icon and an announced message.

- id: `motion-shake-error`
- Page: https://agentic-ui-kit.com/components/motion-shake-error
- Live preview: https://agentic-ui-kit.com/live/component/motion-shake-error

## Install

```bash
agentic-ui add motion-shake-error
npx shadcn@4.17.0 add @agentic-ui/motion-shake-error
```

## Metadata

- **Level:** block
- **Category:** motion
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** horizontal-shake-once-per-error, nudge-variant, guardrail-block-variant, error-icon, error-border, aria-invalid-and-describedby-wiring, live-region-message, reduced-motion-fallback, informative-state-preservation
- **Intents:** authenticate, create-edit, execute-flow
- **Suits domains:** auth, saas, settings, billing, ai-workspace, devtools
- **Interaction:** click, keyboard-navigation
- **Screen role:** flow
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** Password field that shakes once after a wrong-password sign-in, with an error border, an alert icon and an announced message, Email field that nudges once when a form is submitted empty, Guardrail panel that bumps once when an assistant action is blocked by a data policy or when sign-in is paused after repeated failures
- **Avoid when:** Validation while the person is still typing (show the message without motion), Success or neutral feedback (use motion-copy-success or motion-async-button), Long forms with many errors at once (use a validation summary and move focus to it)
- **Preserve when adapting:** one-run-per-error-trigger, aria-invalid-and-describedby, message-in-live-region, border-and-icon-when-motion-is-off
- **Replace when adapting:** message, guardrail-title, icon, intensity
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** input, button
- **npm dependencies:** @agentic-ui/motion, @agentic-ui/tokens, react
- **Motion:** profile subtle, library css, reduced-motion fallback yes, target 60 fps
- **Registry dependencies:** lib-motion