/drift

Drift is an easy to use, reactive, typesafe persistence library for Dart & Flutter.

Primary LanguageDartMIT LicenseMIT

Drift

Note: Moor has been renamed to drift

Build Status Chat on Gitter Using melos

Proudly Sponsored by Stream 💙


Try the Flutter Chat Tutorial  💬

Core Generator
Main version Generator version

Drift is a reactive persistence library for Flutter and Dart, built on top of sqlite. Drift is

  • Flexible: Drift lets you write queries in both SQL and Dart, providing fluent apis for both languages. You can filter and order results or use joins to run queries on multiple tables. You can even use complex sql features like WITH and WINDOW clauses.
  • 🔥 Feature rich: Drift has builtin support for transactions, schema migrations, complex filters and expressions, batched updates and joins. We even have a builtin IDE for SQL!
  • 📦 Modular: Thanks to builtin support for daos and imports in sql files, drift helps you keep your database code simple.
  • 🛡️ Safe: Drift generates typesafe code based on your tables and queries. If you make a mistake in your queries, drift will find it at compile time and provide helpful and descriptive lints.
  • ⚡ Fast: Even though drift lets you write powerful queries, it can keep up with the performance of key-value stores like shared preferences and Hive. Drift is the only major persistence library with builtin threading support, allowing you to run database code across isolates with zero additional effort.
  • Reactive: Turn any sql query into an auto-updating stream! This includes complex queries across many tables
  • ⚙️ Cross-Platform support: Drift works on Android, iOS, macOS, Windows, Linux and the web. This template is a Flutter todo app that works on all platforms.
  • 🗡️ Battle tested and production ready: Drift is stable and well tested with a wide range of unit and integration tests. It powers production Flutter apps.

With drift, persistence on Flutter is fun!

To start using drift, read our detailed docs.

If you have any questions, feedback or ideas, feel free to create an issue. If you enjoy this project, I'd appreciate your 🌟 on GitHub.

Working on this project

This repository contains a number of packages making up the drift project, most notably:

  • drift: The main runtime for drift, which provides most apis
  • drift_dev: The compiler for drift tables, databases and daos. It also contains a fully-featured sql ide for the Dart analyzer.
  • sqlparser: A sql parser and static analyzer, written in pure Dart. This package can be used without drift to perform analysis on sql statements. It's on pub at sqlparser

We use melos to manage the different packages in this repository.

You can install it with dart pub global activate melos. If your Dart SDK was installed as part of Flutter, you can then run melos bootstrap to provision all dependencies. Otherwise, run flutter pub global run melos bootstrap.