{"id":13457821,"url":"https://github.com/alanshaw/david-www","last_synced_at":"2025-04-12T19:47:24.699Z","repository":{"id":6581992,"uuid":"7824282","full_name":"alanshaw/david-www","owner":"alanshaw","description":" :eyeglasses: David helps keep your Node.js project dependencies up to date.","archived":false,"fork":false,"pushed_at":"2022-12-14T17:57:45.000Z","size":5593,"stargazers_count":728,"open_issues_count":60,"forks_count":129,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-04-03T23:09:26.813Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://david-dm.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alanshaw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-25T16:53:11.000Z","updated_at":"2025-03-13T05:53:11.000Z","dependencies_parsed_at":"2023-01-11T20:09:48.854Z","dependency_job_id":null,"html_url":"https://github.com/alanshaw/david-www","commit_stats":null,"previous_names":[],"tags_count":109,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanshaw%2Fdavid-www","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanshaw%2Fdavid-www/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanshaw%2Fdavid-www/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alanshaw%2Fdavid-www/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alanshaw","download_url":"https://codeload.github.com/alanshaw/david-www/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248625497,"owners_count":21135513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T09:00:37.772Z","updated_at":"2025-04-12T19:47:24.665Z","avatar_url":"https://github.com/alanshaw.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Developers","📦 Legacy \u0026 Inactive Projects"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://david-dm.org\"\u003e\u003cimg src=\"https://raw.github.com/alanshaw/david-www/master/david-logo.png\" alt=\"David\" height=\"50\" /\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://travis-ci.org/alanshaw/david-www\"\u003e\u003cimg src=\"https://travis-ci.org/alanshaw/david-www.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n\u003ca href=\"https://david-dm.org/alanshaw/david-www\"\u003e\u003cimg src=\"https://david-dm.org/alanshaw/david-www.svg\" alt=\"Dependency Status\"\u003e\u003c/a\u003e\n\u003ca href=\"https://david-dm.org/alanshaw/david-www/?type=dev\"\u003e\u003cimg src=\"https://david-dm.org/alanshaw/david-www/dev-status.svg\" alt=\"devDependency Status\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nNode.js based web service that tells you when your project npm dependencies are out of date.\nTo use David, your project must include a [package.json](https://docs.npmjs.com/files/package.json)\nfile in your repository.\n\n## Getting Started\n\nWith [Node.js](http://nodejs.org/) and [Grunt](http://gruntjs.com/) installed already,\ndo the following:\n\n* Install david-www:\n\n    ```sh\n    cd /path/to/david-www\n    npm install\n    npm run build\n    ```\n\n* Create a `.davidrc` file (see [Configuration](#configuration) section below)\n* Run david-www:\n\n    ```sh\n    npm start\n    ```\n\n\n## Example usage\n\nView a web page of all dependencies (and their updates, and their versions)\nfor **public** GitHub repository \"grunt-jsio\" owned by \"alanshaw\":\n\n```sh\ncurl http://localhost:1337/alanshaw/grunt-jsio\n```\n\nGet the current build status badge:\n\n```sh\ncurl http://localhost:1337/alanshaw/grunt-jsio.png\n```\n\n### Monorepo or package.json not in root?\n\nYou can use the `path` querystring parameter to specify the path to your `package.json` file. e.g.\n\nhttps://david-dm.org/alanshaw/non-root-package.json?path=src/test\n\n## Configuration\n\nConfiguration is handled by `rc` (https://github.com/dominictarr/rc), see [config.js](src/config.js) for default configuration values.\n\nFor basic configuration, add a `.davidrc` file in the local directory (it is git ignored) and you can use JSON to override any of the default values.\n\nRegister a [github personal oauth token](https://help.github.com/articles/creating-an-access-token-for-command-line-use/) and add it to the config:\n\n```json\n{\n  \"github\": {\n    \"token\": \"some_github_token\"\n  }\n}\n```\n\nYou can also use environment variables e.g.\n\n```\ndavid_github__token=some_github_token\n```\n\n* (Optional) If you want to use \"sign in\" feature you should:\n    * Register a github developer application and add oauth client id and secret to `.davidrc`.\n    * Developer application should have callback URL: `http://localhost:1337/auth/callback`\n\n## Docker Support\n\nThis example will run david-www interactively and will exit and destroy the container upon a control-c.\n\n```\ndocker run -it --rm \\\n  -p 11337:1337 \\\n  -e david_github__token=github-token \\\n  -e david_site__hostname=http://localhost:11337 \\\n  -v /data/david:/opt/data \\\n  david\n```\n\nThis example will run it in detached mode.\n\n```\ndocker run -d --name=\"david-www\" \\\n  --restart=always \\\n  -p 11337:1337 \\\n  -e david_github__token=github-token \\\n  -e david_site__hostname=http://localhost:11337 \\\n  -v /data/david:/opt/data \\\n  david\n```\n\n### Building\n\n```\ndocker build -t david .\n```\n\n---\n\n[![js-standard-style](https://cdn.rawgit.com/feross/standard/master/badge.svg)](https://github.com/feross/standard)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanshaw%2Fdavid-www","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falanshaw%2Fdavid-www","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falanshaw%2Fdavid-www/lists"}