react-native-instant

What problem does it solve?

Eliminate visible loading states and slow navigation in Postgres-backed React Native or Expo apps by favoring fast local reads over delayed remote fetches so users perceive the app as instant and reliable even on flaky networks.

Core Features & Use Cases

• Cache Persistence & Hydration: Persist React Query cache to MMKV and hydrate on app launch to render meaningful content immediately.
• Background Reconciliation: Refetch stale queries quietly and reconcile without erasing the UI to avoid jarring spinners or screen flashes.
• Targeted Prefetching: Warm likely next-screen queries (on mount or onPressIn) and limit prefetching to top-N or first pages to save battery and memory.
• Optimistic Mutations & Offline Queueing: Apply optimistic updates with snapshot/rollback patterns, persist pending mutations, and resume sync on connectivity restoration.
• Use Case Example: A social or commerce app that must show lists and detail screens instantly on reopen, allow instant saves with rollback on failure, and continue working offline with queued sync.

Quick Start

Configure React Query persistence with an MMKV persister, hydrate the cache at app startup to render immediately, perform background refetch and reconciliation, add onPressIn prefetching for critical navigation targets, and implement optimistic mutation patterns with rollback and offline queuing.