# Fx Ripple Background

Empty inbox state with the rings centred on the inbox icon.

- id: `fx-ripple-background`
- Page: https://agentic-ui-kit.com/components/fx-ripple-background
- Live preview: https://agentic-ui-kit.com/live/component/fx-ripple-background

## Install

```bash
agentic-ui add fx-ripple-background
npx shadcn@4.17.0 add @agentic-ui/fx-ripple-background
```

## Metadata

- **Level:** block
- **Category:** effects
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** concentric-rings, concentric-squares, configurable-focal-point, static-focal-glow, token-tone-and-intensity, light-dark-theming, offscreen-pause, reduced-motion-fallback, accessible-decorative-layer
- **Intents:** communicate, monitor-live
- **Suits domains:** saas, ai-workspace, notes, crm, devtools
- **Interaction:** theme-switch, motion-preference
- **Screen role:** overview
- **Density:** comfortable
- **Dark mode:** yes
- **Use it for:** Empty inbox state with the rings centred on the inbox icon, Listening hero behind a voice or microphone control, Waiting-for-first-event panel in a webhook or integration setup, Onboarding step that waits for a device or agent to connect
- **Avoid when:** Dense tables or forms where moving rings compete with data, Signalling a real alert or error, because the effect is decorative and carries no status, Stacking with another ambient background in the same viewport
- **Preserve when adapting:** decorative-layers-aria-hidden, transform-opacity-only-loop, static-rings-fallback
- **Replace when adapting:** variant-and-ring-count, tone-and-intensity, focal-point, container-children
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **npm dependencies:** @agentic-ui/fx-foundation, @agentic-ui/motion, @agentic-ui/tokens, react
- **Motion:** profile subtle, library css, reduced-motion fallback yes, target 60 fps
- **Registry dependencies:** fx-foundation, lib-motion
