Sammy On Couch App or Sittin' On a Couch App
I highly recommend reading the section on couchapps in the CouchDB Book.
soca is a simple command line tool written in ruby for building and pushing couchapps. It is similar to and heavily inspired by the canonical couchapp python tool, couchapp, with a number of key differences.
- local directories do not have to map 1-1 to the design docs directory
- lifecycle hooks for easily adding or modifying the design document with ruby tools or plugins.
- architected around using Sammy.js, instead of Evently, which is bundled with the python tool.
- super tiny and hackable, with the hope that people will contribute patches and plugins.
I'm not one to start a language war, I think python is great and the existing couchapp tool works great for most situations. In fact I've built apps using it. I found myself working around the design documents structure, which makes sense when in JSON, but much less sense when mapped to the filesystem. By making a simple tool, that takes a JSON map of directories and files and places them in their expected JSON slot, you make a new sort of couchapp.
Unlike a traditional couchapp, a soca couchapp is actually one way - you're
source directory is actually 'compiled' into its final state. This allows you
to do things you couldnt before, including bundling js files, using external
tools like compass, and just generally following
your own preffered directory structure. This does mean that there is no
clone to get a couchapp out of CouchDB - though replicating works the same as
before (and is probably faster because you push only the docs you need or
The bottom line is I wanted to build couchapp's with a workflow and structure
I had already established -
soca lets me do that.
soca is bundled as a ruby gem so installation is easy-peasy. On a system
with ruby and ruby gems (OS X for example):
gem install soca
This will give you the
soca bin as long as gems are in your path.
Will display all the command options.
The typical workflow would be:
# Generate the app soca generate myapp # cd into the app cd myapp # edit your .couchapprc with the db url # Do your work, editing app.js, etc # push the app to couchdb soca push # open the app in a browser soca open
Once you get it set up, you can also use
Which will watch the directory and push your changes automagically.
- Better Docs
- More plugins
- More generate options (compass scaffold, etc)
- More example apps
Copyright (c) 2010 Aaron Quint under the MIT License. See LICENSE for details.