Building Todo Lite

Todo Lite is an example app for collaborative task list management. It illustrates many of the Couchbase Lite features, including document CRUD, binary attachments, view queries, authentication, and sync. Once you have it up and running you can read the source code to see examples of using Couchbase Lite in action.

Open the Terminal application.


Terminal is usually located in the Applications/Utilities folder.

Move to your working directory


Change to the directory that you want to store the ToDo Lite app in. For example:

$ cd ~/dev

Clone the example app project


Clone the Todo Lite app:

$ git clone https://github.com/couchbaselabs/ToDoLite-iOS.git

Install the Couchbase Lite framework


  1. In the downloaded Couchbase Lite for iOS folder, find the CouchbaseLite.framework folder.

  2. Copy the CouchbaseLite.framework folder to the Frameworks folder inside the ToDoLite-iOS folder.

Launch the app from Xcode


  1. Double click the ToDoLite.xcodeproj project to open in Xcode.
  2. In Xcode, select an iOS simulator build scheme.

  3. Click Run.

    The ToDo Lite app opens in the iOS simulator.