vaudb_flutter #

Flutter FFI package for the VauDB embedded Rust database engine.

Features #

• Embedded offline database access via dart:ffi
• Key/value CRUD
• Transactions (begin, commit, rollback)
• Table/row CRUD
• Basic filtering (selectWhere)
• Foreign keys with restrict/cascade actions

Windows Setup #

1. Build the Rust engine DLL from vaudb_engine project:

cargo bcopy

2. Place vaudb_engine.dll next to your Flutter app executable:

• Flutter Windows app: windows/runner/vaudb_engine.dll

Example App DLL Integration #

The example Windows CMake now tries these locations automatically:

1. VAUDB_ENGINE_DLL environment variable (full DLL path)
2. example/windows/runner/vaudb_engine.dll

Set env var (PowerShell):

$env:VAUDB_ENGINE_DLL='F:\VARISH\VISUAL STUDIO\Projects\P0-Database\DLL\vaudb_engine.dll'
flutter run -d windows

Usage #

import 'package:vaudb_flutter/vaudb_flutter.dart';

final db = VaudbFlutter();
db.open('app_data.vdb');

db.createTable('users', ['id', 'name']);
db.createTableWithForeignKeys('orders', ['id', 'user_id'], [
  const ForeignKeyDefinition(
    column: 'user_id',
    refTable: 'users',
    refColumn: 'id',
    onDelete: 'cascade',
    onUpdate: 'cascade',
  ),
]);

db.insertRow('users', ['1', 'Varish']);
db.insertRow('orders', ['1', '1']);

final rows = db.selectAll('orders');
print(rows.rows.length);

db.close();

Publish Checklist #

• Update package metadata (name/version/description)
• Ensure LICENSE is present
• Verify flutter test
• Tag release and publish with flutter pub publish