Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The simplest Couchbase Lite demo app for iOS
tree: 525d7dc0b2

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

Grocery Sync for iOS

This is a simple demo app showing how to use the Couchbase Mobile framework to run Apache CouchDB on iOS. The app just presents a simple editable list of textual items, which are stored persistently in a local database, and shared in realtime via a syncpoint in the cloud.

Keep in mind that the default is to share the globally shared grocery list. To use a private grocery list, the user must create a password protected database and then direct Grocery Sync at it via the Settings application. URLs are specified in the form

So this dude is at the grocery store picking up produce and checking it off on his phone. He's all proud looking when he is about to check off the last item on the list, but then... suddenly new items start appearing. Cut to his wife at home with the kids and she's adding items.

Okra? Ok. Coconut milk. But I already got regular milk! He checks them off as he goes. Cut to his wife who sees them marked done, she gets a big grin and starts adding cookies and ice cream and paper towels or whatever.

Getting Started

These instructions assume you are familiar with how to make an iPhone app. Please follow them fully and in order the first time you build.

If you have questions or get stuck or just want to say hi, please visit the Mobile Couchbase group on Google Groups.

Prerequisite: Xcode 4.0.2 or later with the SDK for iOS 4 or later. (It's possible the project might still work with Xcode 3, but we're not testing or supporting this anymore.)

Building The Demo App

Get the main repository

git clone git://

Get the frameworks (CouchCocoa as well as the embedded Couchbase server)

  1. Download the, unzip it, and
  2. Unzip the archive.
  3. Move the uncompressed Frameworks into the root of the iOS-Couchbase-Demo git repo. The .gitignore file is already set up.

Open the Xcode workspace

open CouchDemo.xcworkspace

Build and run the demo app

  1. Select the "CouchDemo" scheme and the appropriate destination (an iOS device or simulator) from the pop-up menu in the Xcode toolbar.
  2. Click the Run button

That's it! Now that you're set up, you can just use the Run command again after making changes to the demo code.

To add the framework to your existing Xcode project

Please see the documentation in the Couchbase Mobile repository.


Portions under Apache, Erlang, and other licenses.

The overall package is released under the Apache license, 2.0.

Copyright 2011, Couchbase, Inc.

Something went wrong with that request. Please try again.