Flutter Data

Persistent reactive models in Flutter with zero boilerplate

Flutter Data is an offline-first persistence framework that gives you a configurable REST client and powerful model relationships.

Heavily inspired by Ember Data and ActiveRecord

Features

• Repositories for all models 🚀
  • CRUD and custom remote endpoints
  • StateNotifier watcher APIs
• Built for offline-first 🔌
  • Hive-based local storage at its core
  • Failure handling & retry API
• Intuitive APIs, effortless setup 💙
  • Truly configurable and composable via Dart mixins and codegen
  • Built-in Riverpod providers for all models
• Exceptional relationship support ⚡️
  • Automatically synchronized, fully traversable relationship graph
  • Reactive relationships

Check out the Documentation or the Tutorial 📚 where we build a TO-DO app from the ground up in record time.

Set up

See the quickstart guide for setup and boot configuration.

Prefer an example? Here's the Flutter Data sample setup app with support for Riverpod, Provider and get_it.

👩🏾‍💻 Usage

For a given

User

@DataRepository

@JsonSerializable()
@DataRepository([MyJSONServerAdapter])
class User with DataModel {
  @override
  final int? id; // ID can be of any type
  final String name;
  User({this.id, required this.name});
  // `User.fromJson` and `toJson` optional
}

mixin MyJSONServerAdapter on RemoteAdapter {
  @override
  String get baseUrl => "https://my-json-server.typicode.com/flutterdata/demo/";
}

After a code-gen build, Flutter Data will generate a

Repository

watchUser

@override
Widget build(BuildContext context) {
  final state = useProvider(watchUser(1));
  if (state.isLoading) {
    return Center(child: const CircularProgressIndicator());
  }
  final user = state.model;
  return Text(user.name);
}

watchUser(1)

repository.watchOne(1)

Let's see how to update the user:

GestureDetector(
  onTap: () =>
      context.read(usersRepositoryProvider).save(User(id: 1, name: 'Updated')),
  child: Text('Update'),
),

repository.watchOne(1)

https://my-json-server.typicode.com/flutterdata/demo/users/1

User

state

DataState

watchOne

reload()

In addition to the reactivity,

DataModel

GestureDetector(
  onTap: () =>
      User(id: 1, name: 'Updated').init(context.read).save(),
  child: Text('Update')
),

Some other examples:

final todo = await Todo(title: 'Finish docs').init(context.read).save();
// POST https://my-json-server.typicode.com/flutterdata/demo/todos/
print(todo.id); // 201

final user = await repository.findOne(1, params: { '_embed': 'todos' });
// GET https://my-json-server.typicode.com/flutterdata/demo/users/1?_embed=todos
print(user.todos.length); // 20
await user.todos.last.delete();

For an in-depth example check out the Tutorial.

Fully functional app built with Flutter Data? See the code for the finished Flutter Data TO-DOs Sample App.

Compatibility

Fully compatible with the tools we know and love:

📲 Apps using Flutter Data

➕ Questions and collaborating

Please use Github to ask questions, open issues and send PRs. Thanks!

On Twitter: @flutterdata

Tests can be run with:

pub run test

📝 License

See LICENSE.