Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Minimalist localStorage database API. Works well as a cache for CouchDB documents.
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
index.js Fix removeItem to reference the correct object.
package.json 0.8.1




npm install browserify
browserify index.js > couchie.js


browser support

Minimalist localStorage database API. Works well as a cache for CouchDB documents.

<script type="text/javascript" src="couchie.js"></script>
<script type="text/javascript">

  // get a database by name
  var db = couchie('name')

  // write a document, MUST include _id and _rev{_id:'550e8400-e29b-41d4-a716-446655440000', _rev:'1-550e8400', data:'test'}, function (e) {
    if (e) throw e

    // get a document by id
    db.get('550e8400-e29b-41d4-a716-446655440000', function (e, doc) {
      if (e) throw e
      doc // {_id:'550e8400-e29b-41d4-a716-446655440000', _rev:'1-550e8400', data:'test'}
      db.revs() // {'550e8400-e29b-41d4-a716-446655440000': '1-550e8400'}

      // write documents in bulk, much more efficient
      db.bulk([ /* array of docs */ ], function (e) {
        if (e) throw e

        // get array of all documents
        db.all(function (e, docs) {
          if (e) throw e
          docs // array of all documents


If localStorage is blocking why is this a callback API?

In the future couchie may implement a few features that require a non-blocking API. The first is lock() which would queue any changes coming in to the database until the lock is removed. The second is pagination across documents for large operations, basically wrapping all the synchronous file access in setTimeout calls so that we don't block the main event loop on large db operations.

When localStorage is not available couchie assumes the environment is node.js and will write to the filesystem. In this case the name of the database is a directory to write files.

Something went wrong with that request. Please try again.