cbl 1.0.0-beta.2

Couchbase Lite for Dart. A NoSQL database with change notification, full text search and replication.

⚠️ This project has not yet reached a stable production release.

Features - Couchbase Lite

• Schemaless JSON documents
• Binary JSON format (Fleece)
  • Reading without parsing
• Blobs
  • A binary data value associated with a document
• Queries
  • Supports large subset of N1QL query language
  • Machine readable representation of queries as JSON
  • Full text search
  • Indexes
  • Observable queries
• Replication
  • Synchronize with Couchbase Server through Sync Gateway

Features - Dart API

• Async and sync APIs
• Streams for event based APIs
• Support for Flutter apps
• Support for standalone Dart (for example a CLI)
• Well documented

Supported Platforms

Platform	Minimum version
iOS	11
macOS	10.15
Android	22

Getting started on Flutter

You need to add cbl and cbl_flutter as dependencies. cbl_flutter currently supports iOS, macOS and Android.

dependencies:
    cbl: ...
    cbl_flutter: ...

Make sure you have set the required minimum target version in the build systems of the platforms you support.

Couchbase Lite needs to be initialized, before it can be used:

import 'package:cbl_flutter/cbl_flutter.dart';

Future<void> initCouchbaseLite() async {
  await CouchbaseLiteFlutter.init();
}

Now you can use Database.open to open a database:

import 'package:cbl/cbl.dart';

Future<void> useCouchbaseLite() async {
  final db = await Database.openAsync('chat-messages');

  final doc = MutableDocument({
    'type': 'message',
    'body': 'Heyo',
    'from': 'Alice',
  });

  await db.saveDocument(doc);

  await db.close();
}

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Read CONTRIBUTING to get started developing.

Disclaimer

Warning: This is not an official Couchbase product.