entidb_flutter 2.0.0-alpha.2

Flutter plugin for EntiDB - an embedded entity database with ACID transactions and CBOR storage. Bundles native libraries for all platforms.

EntiDB Flutter Plugin

Flutter plugin for EntiDB - an embedded entity database with ACID transactions and CBOR storage.

Alpha Release: API may change. Production use at your own discretion.

Platform Support

Platform	Status	Architecture
Android	✅	arm64-v8a, armeabi-v7a, x86_64
iOS	✅	arm64 (device), arm64+x86_64 (simulator)
macOS	✅	Universal (arm64 + x86_64)
Windows	✅	x86_64
Linux	✅	x86_64
Web	❌	Use entidb_web (coming soon)

Installation

Add to your pubspec.yaml:

dependencies:
  entidb_flutter: ^2.0.0-alpha.2

Usage

import 'package:entidb_flutter/entidb_flutter.dart';

void main() async {
  // Open a file-based database
  final db = Database.open('/path/to/database');

  // Or use in-memory for testing
  final memDb = Database.openMemory();

  // Get a collection
  final users = db.collection('users');

  // Generate a unique ID
  final id = EntityId.generate();

  // Store data (CBOR bytes)
  db.put(users, id, Uint8List.fromList([1, 2, 3]));

  // Retrieve data
  final data = db.get(users, id);

  // Use transactions for atomic operations
  db.transaction((txn) {
    txn.put(users, id1, data1);
    txn.put(users, id2, data2);
    // All operations commit atomically
  });

  // Always close when done
  db.close();
}

Minimum Requirements

• Flutter 3.0.0+
• Dart 3.0.0+
• Android SDK 21+ (Android 5.0)
• iOS 12.0+
• macOS 10.14+
• Windows 10+
• Linux (glibc 2.17+)

Architecture

This plugin:

1. Bundles prebuilt native libraries (libentidb_ffi) for each platform
2. Re-exports the pure Dart API from entidb_dart
3. Uses Flutter's FFI plugin mechanism for automatic library loading

Documentation

• API Reference
• GitHub Repository
• Quick Start Guide

Related Packages

• entidb_dart - Pure Dart bindings (requires manual native library setup)
• entidb_web - Web support via WASM (coming soon)

License

MIT OR Apache-2.0