A polished pull-to-refresh controller that lets you drop in any Lottie animation as the indicator. Map pull progress to frames, loop during loading, and finish with success/error sequences—delivering brandable, buttery-smooth reloads that feel native on iOS and Android.

Functionality

• Natural pull-down gesture with configurable threshold and resistance

• Lottie indicator from asset / network / memory with caching

• Progress → frame mapping (scrubs animation while pulling)

• Separate loading loop, success, and error segments

• Adjustable speed, direction, size, alignment, offset, and fit

• Dynamic props: optional color overrides for Lottie layers

• Programmatic API: refresh(), complete(), fail(), reset()

• Debounce/throttle, single-flight guard, timeout & cancellation

• Optional “Last updated” label + haptic feedback on trigger/complete

• Works with ListView, GridView, Slivers, NestedScrollView, pinned bars

• Plays nicely with infinite scroll (top refresh + bottom load)

• Offline-first (cache → revalidate / SWR) with optimistic UI hooks

• Fallback to platform spinner if Lottie fails to load

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

• Light/dark theming; colors, typography, margins, elevation

• Real-device tested; optimized for 60fps with virtualization

• ~16 parameters covering indicator source, segments, styles, and behavior

Use cases

• News/social feeds needing delightful, branded refresh

• E-commerce lists refreshing inventory, prices, or deals

• Media galleries and travel apps with themed Lottie loaders

• Dashboards reloading KPIs, cards, and charts in place

• Messaging/activity timelines re-syncing latest items

• Booking/search results after filter or location changes

• Admin/CMS tables requiring quick requery without navigation

• Seasonal/campaign refreshers (swap Lottie per event)

Keywords
pull to refresh, refresh control, swipe to refresh, Lottie indicator, LottieFiles, animation progress mapping, loading loop, success animation, error animation, threshold, resistance, programmatic refresh, single flight, debounce, throttle, timeout, cached data, SWR pattern, optimistic UI, infinite scroll, list view, grid view, slivers, nested scroll, haptic feedback, last updated label, color override, dynamic properties, dark mode, reduce motion, accessibility, high performance, 60fps, Flutter widget, FlutterFlow component, mobile web, branded loader, smooth animation.