Standalone CouchDB Blog, used by the O'Reilly CouchDB book
Latest commit b1b5c2b Aug 30, 2012 @jchris all strings
Failed to load latest commit information.
_attachments improve comments and header design for 0.11 version Mar 28, 2010
evently move markdown to couchapp vendor Apr 6, 2010
helpers working to rearrange files Mar 2, 2009
lib pathbinder go Mar 24, 2010
lists the rewritten index page still knows which db its in Aug 25, 2010
shows remove the reliance on docForm, used regular jQuery to do the edit Sep 27, 2010
vendor better handling of gravatars Apr 25, 2012
views better handling of gravatars Apr 25, 2012
.gitignore removed and ignored the .couchapprc file Jan 26, 2009 added link to Apache license Apr 6, 2011
THANKS.txt atom feed works again Mar 23, 2010
blog.json improve comments and header design for 0.11 version Mar 28, 2010
couchapp.json validation works better for deletion. Mar 22, 2010
rewrites.json all strings Aug 30, 2012
sofa2.txt link to lowercase tags Mar 24, 2010
validate_doc_update.js admin can update anything Aug 24, 2010

Sofa: Standalone CouchDB Blog

Sofa showcases the potential of pure CouchDB applications. It should provide an easy way for people to put thier thoughts online, anywhere there's a running Couch. It's just HTML, JavaScript and the magic of CouchDB.

Currently supports authoring by anyone with the proper roles, and comments from anyone with a user account.

Current News

Things are moving crazy fast around here right now as I bring this stuff up to ship-shape for the CouchDB book. I'll be renaming methods and stuff (if I find the time), any API feedback will be appreciated.

Install CouchDB

You'll also need CouchDB (verion 0.11 or newer). Once you have that installed and the tests passing, you can install CouchApp and the blog software.

Install CouchApp

CouchApp makes it easy to edit application that are hosted in CouchDB, by keeping a correspondence between a set of files, and a CouchDB design document. You'll use CouchApp to install Sofa in your CouchDB instance.

sudo easy_install couchapp

CouchApp is a set of utilities for developing standalone CouchDB applications You can learn more about the CouchApp project here. Also, easy_install has an unpleasant bug on OSX, so you might end up having to work from git source.

Setup Admin Access

If you are going to put your blog in public, you'll want to set up an Admin account (screencast).

Install Sofa

git clone git://
cd sofa
couchapp push . http://user:pass@ 

You'll want to edit the HTML and CSS to personalize your site. Don't worry, the markup is pretty basic, so it's easy to rework. Adding new features is just a few lines of JavaScript away.

Anytime you make edits to the on-disk version of Sofa, and want to see them in your browser, just run couchapp push . again. You probably want to setup your .couchapprc file. You should read the CouchApp readme to learn about that.

You can customize the blog title and other stuff in the blog.json file.


Visit your new blog.


Licensed under Apache 2.0: