Skip to content

Commit f77879b

Browse files
committed
flutter_query: v0.4.0 -> v0.5.0
- Update CHANGELOG - Update README
1 parent 261fb8c commit f77879b

3 files changed

Lines changed: 60 additions & 2 deletions

File tree

packages/flutter_query/CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,13 @@
1+
## 0.5.0 (2025-01-14)
2+
3+
This release adds support for infinite/paginated queries.
4+
5+
- `useInfiniteQuery` hook for paginated data fetching with automatic page accumulation
6+
- `fetchNextPage` and `fetchPreviousPage` for bidirectional pagination
7+
- `hasNextPage` and `hasPreviousPage` state for pagination controls
8+
- `maxPages` option to limit the number of accumulated pages
9+
- Full support for all standard query options (caching, refetching, retry, etc.)
10+
111
## 0.4.0 (2025-01-08)
212

313
This release aligns the API with TanStack Query v5.

packages/flutter_query/README.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

packages/flutter_query/README.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
<p align="center">
2+
<img src="https://raw.githubusercontent.com/jezsung/query/main/assets/logo.svg" alt="flutter_query logo" width="80">
3+
</p>
4+
5+
<h1 align="center"><samp>Flutter Query</samp></h1>
6+
7+
<p align="center">
8+
<a href="https://github.com/jezsung/query/actions/workflows/ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/jezsung/query/ci.yaml?label=CI" alt="CI"></a>
9+
<a href="https://github.com/jezsung/query/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-purple.svg" alt="License"></a>
10+
<a href="https://github.com/jezsung/query"><img src="https://img.shields.io/github/stars/jezsung/query?style=flat&logo=github&colorB=F6F8FA&label=Github Stars" alt="GitHub Stars"></a>
11+
</p>
12+
13+
Powerful asynchronous state management for Flutter, inspired by [TanStack Query](https://tanstack.com/query/latest). Simplifies data fetching, caching, and updates with minimal boilerplate.
14+
15+
> **Coming from TanStack Query?** Check out the [differences](https://flutterquery.com/docs/coming-from-tanstack-query) to get started quickly.
16+
17+
## Why Flutter Query?
18+
19+
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:
20+
21+
- **Automatic Caching:** Cache management with configurable stale times
22+
- **Request Deduplication:** Multiple widgets share a single network request
23+
- **Background Refetching:** Keep data fresh with automatic background updates
24+
- **Stale-While-Revalidate:** Show cached data instantly while fetching updates
25+
- **Optimistic Updates:** Responsive UI with rollback on failure
26+
- **Infinite Queries:** Built-in pagination for infinite scrolling view
27+
- **Automatic Retries:** Configurable retry logic with exponential backoff
28+
- **Lifecycle Aware:** Automatic refetch on app resume
29+
30+
## Documentation
31+
32+
Visit **[flutterquery.com](https://flutterquery.com)** for comprehensive documentation:
33+
34+
- [Quick Start](https://flutterquery.com/docs/quick-start)
35+
- [Queries](https://flutterquery.com/docs/concepts/queries)
36+
- [Mutations](https://flutterquery.com/docs/concepts/mutations)
37+
- [Infinite Queries](https://flutterquery.com/docs/reference/use-infinite-query)
38+
- [Staleness](https://flutterquery.com/docs/concepts/staleness)
39+
- [Query Lifecycle](https://flutterquery.com/docs/concepts/query-lifecycle)
40+
41+
## Versioning
42+
43+
This project strictly follows [Semantic Versioning](https://semver.org/). Given a version number `MAJOR.MINOR.PATCH`:
44+
45+
- **MAJOR** version increments indicate breaking changes
46+
- **MINOR** version increments add functionality in a backward-compatible manner
47+
- **PATCH** version increments include backward-compatible bug fixes
48+
49+
Before version 1.0.0, MINOR version increments may include breaking changes.

packages/flutter_query/pubspec.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
name: flutter_query
22
description: An async state management package that simplifies data fetching, caching, and updates.
3-
version: 0.4.0
3+
version: 0.5.0
44
repository: https://github.com/jezsung/query/tree/main/packages/flutter_query
55

66
environment:

0 commit comments

Comments
 (0)