# Mobile Pull Refresh

Mobile notification feed that reloads by dragging from the top edge.

- id: `mobile-pull-refresh`
- Page: https://agentic-ui-kit.com/components/mobile-pull-refresh
- Live preview: https://agentic-ui-kit.com/live/component/mobile-pull-refresh

## Install

```bash
agentic-ui add mobile-pull-refresh
npx shadcn@4.17.0 add @agentic-ui/mobile-pull-refresh
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** pull-gesture, rubber-band-damping, threshold-arming, determinate-progress-indicator, async-refresh-lifecycle, success-confirmation, error-recovery, reduced-motion-fallback, disabled-surface, empty-state-handling
- **Intents:** monitor-live, manage-collection, track-status, navigate
- **Suits domains:** saas, operations, social, ecommerce, logistics, devops-status
- **Interaction:** pull-gesture, pointer-drag, keyboard-retry, live-region
- **Screen role:** overview
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** mobile notification feed that reloads by dragging from the top edge, order list in a delivery app that refreshes status without a visible button, incident inbox in an on-call console checked from a phone, empty collection that allows retrying the load without a visible control
- **Avoid when:** desktop surfaces with an explicit, always-visible refresh control, paginated content where the gesture competes with upward infinite scroll, data that only changes through the user's own action
- **Preserve when adapting:** gesture-threshold-model, phase-lifecycle, indicator-feedback-contract, accessibility-announcements
- **Replace when adapting:** refresh-callback, indicator-copy, list-content
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives, lib-tokens