This repository has been archived by the owner. It is now read-only.
A object mapper for couchdb
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

LazyBoy Object Modeller

Build Status

Oh my word... What have you done?

LazyBoy makes it easier to build applications with Couchdb. It removes the repeatable cruft and makes working with Couchdb as fun as it should be.

4 easy steps to installation

  1. Download

    npm install lazyboy

  2. Connect to database

    var Model = require('lazyboy') Model.create_connection("my_database");

  3. Define a model

    Model.define('User', { name: String surname: {type: String, default: "Rambo"} })

  4. Read the docs:

How do I use this it?

Below is a quick cheatsheet but the docs can be found at

Defining a model

var Model = require('LazyBoy');

Model.define('User', {
  name: String
  surname: {type: String, default: "Rambo"}

Creating and saving a model

var user = Model.create('User', {name: "John", surname: "Rambo"}); (err, saved_user) {
    // .. do some other stuff here

Finding a model

Finding by Id

var user_id = "123456";

var User = Model('User');
User.find(user_id, function (err, user) {
    // .. do something with the user

Find all or by criteria

var User = Model('User');
User.all(function (err, users) {
    // .. do something with the user

var User = Model('User');
User.where("name","Ben", function (err, users) {
    // .. do something with the users

Find first by criteria

var User = Model('User');
User.findFirst('name', 'Ben', function (err, user){
  // .. do something with the user

Custom View

var Band = Model.define("Band",{rank: Number, name: String});

  map: function (doc) {
    if (doc.model_type === 'Band') {

  .startkey([2, "Incubus"])
  .endkey([3, {}])
  .skip(3, function (err, bands) {
   // will only execute the chain when a function has a callback passed to it


Logging has been disabled for now.

What needs doing?

  • Define model_type field stored in db
  • Multiple db support
  • Improved logging


  • 16 May 2013 - Add findFirst
  • 24 October 2012 - Add Chainable Api
  • 25 July 2012 - Bug fixes, change tests to mocha
  • 20 July 2012 - Added toJSON function on Document
  • 11 Nov 2011 - Added Validations using node-validator
  • 13 Sep 2011 - Add Id to serialised model
  • 11 Sep 2011 - Add Before And After Remove Callbacks (Donnie Hedin)
  • 17 Aug 2011 - Add support for custom methods


  • Sven Bergström (underscorediscovery)
  • Donnie Hedin (sofa420)
  • 8bitDesigner