Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including pouchdb-design with all npm packages installed. Try it out:

var pouchdbDesign = require("pouchdb-design")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

pouchdb-design v1.2.5

Design doc helpers for PouchDB.

PouchDB Design Document Helpers

npm Build Status

A PouchDB plugin for easier handling of CouchDB design documents.


Install via NPM:

npm i pouchdb-design -S

And use like any normal PouchDB plugin:

const pouchdesign = require("pouchdb-design");


This plugin revolves around a class for managing a single design document. Instances of the class have several methods for fetching and saving, modifying design document properties, and adding custom functions and commonjs modules.

The typical flow is to fetch the existing design document, make some changes, and then save it back to database.

const design ="mydesign");

design.fetch().then(() => {
  design.view("allDocs", function(doc) {
    emit(doc._id, { rev: doc._rev });

}).catch(e => {

API [ docOrId ] ) → Design

This plugin attaches the method .design() to PouchDB instances. When called, it will return a Design object. It takes a single argument, which is an existing design document or a string id. If the id does not start with _design/, it is added automatically.

const design ="mydesigndoc");
const design ="_design/mydesigndoc");
const design ={ _id: "_design/mydesigndoc" });


design.fetch() → Promise<this>

This method will retrieve the existing design document from the database. Once complete, the existing design document is set internally for use by other synchronous methods.

If the design document does not exist, this method will continue successfully and set a blank, new document internally. → Promise<this>

This will save the internal design document back to the database. This works like an upsert, where it will be created if it doesn't exist, or overwrites the existing.


design.toJSON() → object

Returns the CouchDB design document that the instances represents


design.clone() → designCopy

Returns an exact duplicate of this design object.

Gets and sets the design's id. When setting, you can leave off the _design/ and it will be automatically added. = "mydesign";
console.log(; // _design/mydesign


design.get( key ) → mixed

Returns the exact value at key in the design document. This supports dot separated keys for deep values.


design.set( key, value ) → this

Sets value to key in the design document. Like .get(), key supports dot separated syntax for deep values. The value is normalized to be compatible with JSON and CouchDB. Functions, for example, are converted into strings.


design.unset( key ) → this

Removes the value at key in the design document. Like .get(), key supports dot separated syntax for removing deep values.


design.view( name, map [, reduce ] ) → this
design.view( name, mapReduceObj ) → this
design.view( viewObj ) → this

Adds a map and reduce view to the design document under name. Several syntaxes are accepted, depending on if you have a reduce method to set in addition to the map.


design.list( name, fn ) → this
design.list( listObj ) → this

Adds a list method to the design document under name. Several list methods can be set using an object. name, fn ) → this showObj ) → this

Adds a show method to the design document under name. Several show methods can be set using an object.


design.update( name, fn ) → this
design.update( updateObj ) → this

Adds a update method to the design document under name. Several update methods can be set using an object.


design.filter( name, fn ) → this
design.filter( filterObj ) → this

Adds a filter method to the design document under name. Several filter methods can be set using an object.


design.validate( fn ) → this

Adds a validate_doc_update method to the design document.


design.lib( key, value ) → this

Adds a commonjs module to the design document. This will prefix the value with module.exports = so that it can be required by other methods in the design document. The key uses .set() under the hood so it can be dot-separated for deep values.


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free