🧠 NebulaDB

⚡ Lightweight embedded SQL database engine written in pure Dart

---

🚀 Overview

NebulaDB is a lightweight, embedded relational database engine built entirely in Dart.

It provides a full SQL execution pipeline with persistent storage and Write-Ahead Logging (WAL).

---

✨ Features

• SQL parser & executor
• WHERE / JOIN / GROUP BY
• B-Tree indexing
• Page-based storage (4KB)
• WAL + crash recovery
• Basic transactions

---

📦 Installation

dart pub add nebula_db

---

⚡ Quick Example

import 'nebula_db.dart';

void main() async {
  final db = await NebulaDB.open('./my_db');

  await db.execute('''
    CREATE TABLE users (
      id INT,
      name TEXT,
      age INT
    )
  ''');

  await db.execute("INSERT INTO users VALUES (1, 'Ahmed', 25)");

  final result = await db.execute('SELECT * FROM users');
  result.prettyPrint();

  await db.close();
}

---

🎯 Use Cases

• Flutter apps (offline-first)
• Embedded/local databases
• Learning database internals

---

⚠️ Limitations

• Single-process only
• No advanced concurrency yet
• Not designed for large-scale production

---

🧪 Testing

dart test

---

📄 License

MIT License

---