Give lists and grids a silky reload with custom pull to refresh 💧 — a gesture-driven control with an animated drop/wave indicator 🌊 that flows through pull → armed → loading → success/error. Haptics 📳, smooth snap-back 🎯, and full theming 🎨 make refreshes feel native and delightful on real devices.

Functionality ⚙️

• 👇 Natural pull-down gesture with configurable threshold & resistance

• 🔄 Indicator states: pull → armed → loading → success/error with snap-back

• 🧩 Custom indicators: spinner, arrow→spinner morph, wave/drop, or Lottie

• 📳 Haptic feedback on trigger; optional sound/vibration

• 🧩 Programmatic API to refresh without a gesture

• 🚦 Guards: debounce, timeout, minimum interval

• 🧱 Works with ListView, GridView, CustomScrollView/Slivers, nested scrolls

• 🕒 Optional Last updated label + ✔️ Done checkmark

• 🧯 Error handling: snackbar/toast + Retry callback

• ♾️ Plays nicely with infinite scroll/pagination (top refresh)

• 📶 Offline-first (SWR): cache → revalidate

• 🧷 Safe-area aware; supports translucent status bars

• 🎨 Theming: colors, sizes, indicator shape, corner radius, shadows

• ♿ Accessibility: semantics, large hit targets, reduce-motion support

• 🪝 Callbacks: onPullStart, onCancel, onRefresh, onSuccess, onError

Use cases 💡

• 🗞️ Social/news feeds needing quick manual reloads

• 🛒 E-commerce category/product lists fetching new stock

• 📊 Dashboards refreshing KPIs, cards, and charts in place

• 💬 Messaging & activity timelines re-syncing data

• 🔎 Booking/search results after filter changes

• 🖼️ Media libraries (albums/playlists) pulling new items

• ✈️ Offline apps surfacing cached → fresh content on demand

• 🛠️ Admin/CMS tables requiring instant requery without navigation

Keywords (one line, lowercase) 🔑

custom pull to refresh, pull to refresh widget flutterflow, swipe to refresh, drag to refresh, elastic indicator, wave indicator, drop indicator, spinner, arrow morph, success checkmark, last updated label, debounce, timeout, retry action, error state, haptic feedback, programmatic refresh, infinite scroll, pagination, cache then network, swr, offline first, slivers, list view, grid view, nested scroll, safe area, reduce motion, accessibility, theming, dark mode, mobile web, flutter widget, flutterflow component, smooth animation, high performance