Pull to refresh
Classic and Material headers, shared messages, colors, haptics, and completion behavior.
Native refresh interactions for React Native 0.76+
expo-smartrefreshlayout
Fabric-native pull-to-refresh and load-more behavior for Android and iOS, with predictable completion for gesture and programmatic requests.
FabricAndroidiOSExpo dev build
One container, a complete request lifecycle
Native motion with predictable JavaScript state.
Promise-aware callbacks, controlled state, instance commands, and stale-request protection keep gesture and network state aligned.
Load more
Pull-release by default or guarded automatic loading after a real upward scroll.
Android second-floor interaction
Android TwoLevelHeader provides a separate full-screen interaction with open and close commands.
Request lifecycle
Accept once. Finish the matching request.
- 01
Gesture or command
Native accepts a refresh or page request only while the instance is idle.
- 02
JavaScript work
The callback receives a requestId and may return a Promise or the next hasMore value.
- 03
Native completion
Uncontrolled mode closes automatically; controlled mode follows your prop state.
Install
Add one Fabric component.
New Architecture is required. Expo projects need a development build; Expo Go is not supported.
npm install expo-smartrefreshlayout@nextRead the setup guide