{"id":19494694,"url":"https://github.com/ceejbot/consensus","last_synced_at":"2025-10-24T21:43:12.201Z","repository":{"id":57205961,"uuid":"12040615","full_name":"ceejbot/consensus","owner":"ceejbot","description":"vote on topics for your next big meeting","archived":false,"fork":false,"pushed_at":"2017-05-02T18:08:50.000Z","size":349,"stargazers_count":17,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-19T12:27:53.832Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","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/ceejbot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-08-11T18:44:34.000Z","updated_at":"2019-07-11T15:52:51.000Z","dependencies_parsed_at":"2022-09-18T01:01:49.089Z","dependency_job_id":null,"html_url":"https://github.com/ceejbot/consensus","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/ceejbot/consensus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceejbot%2Fconsensus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceejbot%2Fconsensus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceejbot%2Fconsensus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceejbot%2Fconsensus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ceejbot","download_url":"https://codeload.github.com/ceejbot/consensus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ceejbot%2Fconsensus/sbom","scorecard":{"id":270348,"data":{"date":"2025-08-11","repo":{"name":"github.com/ceejbot/consensus","commit":"86dd3615b926677a6c8ff4147f250bf789389313"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 1/26 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 7 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T13:10:33.436Z","repository_id":57205961,"created_at":"2025-08-17T13:10:33.437Z","updated_at":"2025-08-17T13:10:33.437Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280872032,"owners_count":26405606,"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","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-11-10T21:32:11.060Z","updated_at":"2025-10-24T21:43:12.167Z","avatar_url":"https://github.com/ceejbot.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Consensus\n\nImagine a Google Moderator that didn't make you tear your hair out. That's Consensus.\n\n[![NPM](https://nodei.co/npm/consensus.png)](https://nodei.co/npm/consensus/)\n\n[![Stories in Ready](https://badge.waffle.io/ceejbot/consensus.png?label=ready)](https://waffle.io/ceejbot/consensus)  \n\n## What's that when it's at home?\n\nConsensus is a tool for counting votes on topics proposed by its users. Topics are grouped into \"agendas\", which are lists of things to consider at meeting. Any Consensus user can create an agenda. Any Consensus user can propose a topic for any agenda. Votes are private *only* in the sense that they're not exposed by default in the UI, though you could show them if you wanted.\n\n[Here's a quick demo movie showing what it does](https://cloudup.com/cWPa8l1RdsF).\n\nBetter yet: here's a [demo site](http://demo.consensoid.io/) that you can try out.\n\nUse it anywhere where you'd like a medium-sized group of people to vote on things regularly.\n\n### Features\n\n- automatic account provisioning \u0026 signin via [Mozilla Persona](https://www.mozilla.org/en-US/persona/)\n- \"agendas\" to group proposed topics by meeting\n- open topic proposal\n- open voting\n- changeable votes\n- markdown formatting for everything with a description\n- presentation mode for meetings to review open requests\n\n## Operational requirements\n\nConsensus stores its data in a set of leveldb databases, which are saved on disk. You'll wish to have sufficient fast disk to support your expected use. For small, less-active installations, just about anything will do. You'll also want to back those files up if the data Consensus stores is valuable to you. \n\nConsensus makes no attempt to restrict access to the data or to account creation. If you have access to the site, you can create an account using [Mozilla Persona](https://www.mozilla.org/en-US/persona/). It is intended to be used behind a firewall. Note that it must be able to make outgoing connections at least to `verifier.login.persona.org:443` to verify user identities.\n\n## Installing\n\nClone the repo or `npm install consensus`. Copy the sample config file in `config.json.sample` to `config.json` and edit to your satisfaction.\n\n```javascript\n{\n\t\"name\": \"My Site Name\",\n\t\"port\":    3000, // may be overridden by setting PORT env var\n\t\"dbpath\":  \"/var/db/consensus\",\n\t\"logging\": \n\t{\n\t\t\"path\": \"/var/log/consensus\",\n\t\t\"console\": false\n\t},\n\t\"secrets\": [\"your cookie secret passphrase thingie\", \"which get passed to keygrip\" ],\n\t\"avatars.io\":\n\t{\n\t\t\"public\":  \"your-public-access-token\",\n\t\t\"private\": \"your-private-oauth-token\",\n\t\t\"appid\":   \"your-app-id\"\n\t}\n}\n```\n\nYou may also pass in the location of the config file using the `CONFIG_FILE` environment variable.\n\nInstall dependencies: `npm install`.\n\nThen start the app: `npm start`.\n\n## Avatars.io integration\n\nConsensus can use [avatars.io](http://avatars.io/) to provide custom avatars for your users. You will need to sign up for a free application account and modify the config file to supply your tokens.\n\n## Customizing\n\nThe CSS framework is [Bootstrap 3.0](http://getbootstrap.com). You should be able to drop in any Bootstrap theme or customized CSS to style the app your way. The LESS files used to customize the colors are all available in `./build/less`. Simply run `bower install` and then `make` to compile the css.\n\n## API\n\nA few json endpoints are implemented. Eventually there will be more in support of whatever in-browser interactivity I need.\n\n## Hat-tips\n\nThis project was greatly enhanced by the following open-source projects:\n\n* [Mozilla Persona](https://www.mozilla.org/en-US/persona/)\n* [levelup](https://github.com/rvagg/node-levelup)\n* [express.js](http://expressjs.com)\n* [Reveal.js](http://lab.hakim.se/reveal-js/)\n* [Bootstrap](http://getbootstrap.com/)\n* [1pxdeep](http://rriepe.github.io/1pxdeep/)\n* [Font Awesome](http://fortawesome.github.io/Font-Awesome/)\n\nSee also its [hackers.txt](hackers.txt), generated by [hacker-deps](https://github.com/substack/hacker-deps).\n\n## TODO before I call it 1.0\n\n- add anonymous voting\n- show winning topics more clearly\n- implement delete account\n- make it a js in-page app\n- switch socket.io to [primus](http://primus.io)\n- use websockets to do streaming updates\n- improve config \u0026 deployment story\n- maybe write *one* test\n- fall back to gravatars without avatars.io integration\n- improve avatar upload cosmetics\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fceejbot%2Fconsensus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fceejbot%2Fconsensus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fceejbot%2Fconsensus/lists"}