Lightweight, embedded, syncable NoSQL database engine for iOS (and Mac!) apps.
Objective-C Swift Objective-C++ Shell CSS C Other
Switch branches/tags
Latest commit 32d0734 Feb 22, 2018

Couchbase Lite 2.0 (Beta)

Couchbase Lite is an embedded lightweight, document-oriented (NoSQL), syncable database engine.

Couchbase Lite 2.0 has a completely new set of APIs. The implementation is on top of Couchbase Lite Core, which is also a new cross-platform implementation of database CRUD and query features, as well as document versioning.


  • iOS 9.0+ | macOS 10.11+ | tvOS 9.0+
  • Xcode 9



You can use CocoaPods to install CouchbaseLite for Objective-C API or CouchbaseLiteSwift for Swift API by adding it in your Podfile:

CouchbaseLite (Objective-C API)

target '<your target name>' do
  pod 'CouchbaseLite', :git => '', :tag => '2.0DB022', :submodules => true

CouchbaseLiteSwift (Swift API)

target '<your target name>' do
  pod 'CouchbaseLiteSwift', :git => '', :tag => '2.0DB022', :submodules => true


You can use Carthage to install CouchbaseLite by adding it in your Cartfile:

github "couchbase/couchbase-lite-ios" "2.0DB022"

When running carthage update or build, Carthage will build both CouchbaseLite and CouchbaseLiteSwift framework.

How to build the framework files.

  1. Clone the repo and update submodules
$ git clone
$ git submodule update --init --recursive
$ cd couchbase-lite-ios
  1. Run ./Scripts/ to build a platform framework which could be either an Objective-C or a Swift framework. The supported platforms include iOS, tvOS, and macOS.
$ ./Scripts/ -s "CBL ObjC" -p iOS -o output    // For building the ObjC framework for iOS
$ ./Scripts/ -s "CBL Swift" -p iOS -o output   // For building the Swift framework for iOS


Sample Apps

  • Todo : Objective-C and Swift


Like all Couchbase source code, this is released under the Apache 2 license.