6.1. Fauxton Setup

Fauxton is included with CouchDB 2.0, so make sure CouchDB is running, then go to:

  1. http://127.0.0.1:5984/_utils/

You can also upgrade to the latest version of Fauxton by using npm:

  1. $ npm install -g fauxton
  2. $ fauxton

(Recent versions of node.js and npm are required.)

6.1.1. Fauxton Visual Guide

You can find the Visual Guide here:

http://couchdb.apache.org/fauxton-visual-guide

6.1.2. Development Server

Recent versions of node.js and npm are required.

Using the dev server is the easiest way to use Fauxton, specially when developing for it:

  1. $ git clone https://github.com/apache/couchdb-fauxton.git
  2. $ npm install && npm run dev

6.1.3. Understanding Fauxton Code layout

Each bit of functionality is its own separate module or addon.

All core modules are stored under app/module and any addons that are optional are under app/addons.

We use backbone.js and Backbone.layoutmanager quite heavily, so best to get an idea how they work. Its best at this point to read through a couple of the modules and addons to get an idea of how they work.

Two good starting points are app/addon/config and app/modules/databases.

Each module must have a base.js file, this is read and compile when Fauxton is deployed.

The resource.js file is usually for your Backbone.Models and Backbone.Collections, view.js for your Backbone.Views.

The routes.js is used to register a url path for your view along with what layout, data, breadcrumbs and api point is required for the view.

6.1.3.1. ToDo items

Checkout JIRA or GitHub Issues for a list of items to do.