migrant 0.0.8 copy "migrant: ^0.0.8" to clipboard
migrant: ^0.0.8 copied to clipboard

A simple database schema migration tool

Database schema migration tool for Dart #

A super simple tool which reads the migrations from some source (e.g. from the local file system) and applies them to a database (e.g. PostgreSQL or SQLite). Nothing fancy.

Supported migrations sources:

Supported database engines:


import 'dart:io';

import 'package:migrant/migrant.dart';
import 'package:migrant_db_sqlite/migrant_db_sqlite.dart';
import 'package:migrant_source_fs/migrant_source_fs.dart';
import 'package:sqflite_common_ffi/sqflite_ffi.dart';

Future<void> main() async {
  // Migration files must start with 4 digits which define the version.
  final fileNameFormat = FileNameFormat(RegExp(r'\d{4}'));

  // Reading migrations from this directory.
  // Try adding more migrations in there!
  final directory = Directory('example/migrations');

  // Migration source.
  final migrations = LocalDirectory(directory, fileNameFormat);

  if (Platform.isWindows || Platform.isLinux) {
    // Initialize FFI

  // This is where the database file is placed.
  print("Database path:" + await databaseFactoryFfi.getDatabasesPath());

  // The SQLite connection. We're using a local file.
  var connection = await databaseFactoryFfi.openDatabase('example.db');

  // The gateway is provided by this package.
  final gateway = SQLiteGateway(connection);

  // Extra capabilities may be added like this. See the implementation below.
  final loggingGateway = LoggingGatewayWrapper(gateway);

  // Applying migrations.
  await Database(loggingGateway).migrate(migrations);

  // At this point the table "foo" is ready.
  await connection.insert('test', {
    'id': DateTime.now().toIso8601String(),
    'foo': 'hello',
    'bar': 'world',

  // See some data inserted.
  print(await connection.query('test'));

// Compose everything!
class LoggingGatewayWrapper implements DatabaseGateway {

  final DatabaseGateway gateway;

  Future<void> apply(Migration migration) async {
    print('Applying version ${migration.version}...');
    await gateway.apply(migration);
    print('Version ${migration.version} has been applied.');

  Future<String?> currentVersion() async {
    final version = await gateway.currentVersion();
    print('The database is at version $version.');
    return version;