query

Flutter Query

A Flutter package inspired by TanStack Query for powerful asynchronous state management. Built with Flutter Hooks.

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

Why Flutter Query?

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

• Automatic caching with intelligent invalidation
• Request deduplication so multiple widgets share a single network request
• Background updates to keep data fresh
• Stale-while-revalidate patterns for instant UI with fresh data
• Optimistic updates for responsive mutations
• Retry logic with exponential backoff

Documentation

Visit flutterquery.com for the full documentation, tutorials, and guides.

Platform Support

Android	iOS	macOS	Web	Linux	Windows
✅	✅	✅	✅	✅	✅

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.

Support

If you find Flutter Query useful, consider giving it a ⭐ to help others discover it!