Flutter Query

Powerful asynchronous state management for Flutter, inspired by TanStack Query. Simplifies data fetching, caching, and updates with minimal boilerplate.

Coming from TanStack Query? Check out the differences to get started quickly.

Why Flutter Query? #

Working with server data is hard. You need caching, request deduplication, background refetching, stale data handling, and more. Flutter Query handles all of this out of the box:

• Automatic Caching: Cache management with configurable stale times
• Request Deduplication: Multiple widgets share a single network request
• Background Refetching: Keep data fresh with automatic background updates
• Stale-While-Revalidate: Show cached data instantly while fetching updates
• Optimistic Updates: Responsive UI with rollback on failure
• Infinite Queries: Built-in pagination for infinite scrolling view
• Automatic Retries: Configurable retry logic with exponential backoff
• Lifecycle Aware: Automatic refetch on app resume

Documentation #

Visit flutterquery.com for comprehensive documentation:

• Overview
• Quick Start

Supported Hooks #

• useQuery
• useMutation
• useInfiniteQuery
• useQueryClient
• useIsFetching
• useIsMutating
• useMutationState

Platform Support #

Requirements #

• Flutter >=3.32.0
• Dart >=3.0.0 <4.0.0

Versioning #

This project strictly follows Semantic Versioning. Given a version number MAJOR.MINOR.PATCH:

• MAJOR version increments indicate breaking changes
• MINOR version increments add functionality in a backward-compatible manner
• PATCH version increments include backward-compatible bug fixes

Before version 1.0.0, MINOR version increments may include breaking changes.