---

Node.js based web service that tells you when your project npm dependencies are out of date. To use David, your project must include a package.json file in the root of your repository.

Getting Started

With Node.js and Grunt installed already, do the following:

Install david-www:

cd /path/to/david-www
npm install
grunt

Register a github personal oauth token and add it to config/default.json.

(Optional) If you want to use "sign in" feature you should:

• Register a github developer application and add oauth client id and secret to config/default.json.
• Developer application should have callback URL: http://localhost:1337/auth/callback

Run david-www:

node .

Example usage

View a web page of all dependencies (and their updates, and their versions) for public GitHub repository "grunt-jsio" owned by "alanshaw":

curl http://localhost:1337/alanshaw/grunt-jsio

Get the current build status badge:

curl http://localhost:1337/alanshaw/grunt-jsio.png

Use the npm-shrinkwrap.json file as base for the required package version:

curl http://localhost:1337/alanshaw/grunt-jsio.png?shrinkwrap=true

Configuration

Configuration is handled by rc (https://github.com/dominictarr/rc), see the repo for full usage.

For basic configuration, add a .davidrc file in the local directory (it is git ignored) and you can you JSON to override any of the default values.

Example:

{
  "github": {
    "token": "some_github_token"
  }
}

You can also use environment variables.

Example:

david_github__token=some_github_token

Docker Support

This example will run david-www interactively and will exit and destroy the container upon a control-c.

docker run -it --rm \
  -p 11337:1337 \
  -e david_github__token=github-token \
  -e david_site__hostname=http://localhost:11337 \
  -v /data/david:/opt/data \
  david

This example will run it in detached mode.

david run -d --name="david-www" \
  --restart=always \
  -p 11337:1337 \
  -e david_github__token=github-token \
  -e david_site__hostname=http://localhost:11337 \
  -v /data/david:/opt/data \
  david

Building

docker build -t david .