francescreig/ferry

Stream-based strongly typed GraphQL client for Dart

⚠️ Notice: Looking for maintainers

While we are using this package in our own production applications, we don't have the resources to maintain the project beyond our immediate needs. If anyone would like to help maintain the project, we'd be happy to support and empower wherever possible.

A simple, powerful GraphQL Client for Flutter and Dart

Documentation 📖

Features

1. ✅ Fully Typed: work faster and safer with compile time checks and IDE autocomplete, including fully typed Cache reads and writes.
2. 🔄 Built-In Code Generators: automatically generated immutable data classes for all your GraphQL Operations and Fragments, based on your schema.
3. 🌐 Customizable Network Interface: highly customizable network interface using gql_link, allowing you to compose and extend Links.
4. ✨ Normalized Optimistic Cache: keep data in sync with cache normalization and update your UI instantly with optimistic data.
5. 💾 Multiple Data Stores: extensible Store interface with built-in MemoryStore and HiveStore (which uses hive for offline persistence).
6. 📄 Refetch & Pagination: easily update responses with new data or combine multiple responses, allowing for seamless pagination.
7. 📱 Flutter Widgets: Widgets for Queries, Mutations, and Subscriptions, available out of the box.

Packages

This repo is a monorepo for ferry and related packages.

Pub	Package	Description
	package:ferry	Stream-based GraphQL Client
	package:ferry_cache	Normalized, strongly typed, optimistic cache
	package:ferry_exec	Strongly typed GraphQL execution interface
	package:ferry_flutter	Flutter Widgets for GraphQL Operations
	package:ferry_generator	Dart Type Generator for GraphQL Operations
	package:ferry_store	Data Persistence for ferry's cache
	package:ferry_hive_store	Hive implementation of ferry_store
	package:normalize	Normalization / denormalization of GraphQL data