{"id":27962348,"url":"https://github.com/thoughtworks/byor-voting-web-app","last_synced_at":"2025-06-15T03:02:53.828Z","repository":{"id":38175822,"uuid":"187018317","full_name":"thoughtworks/byor-voting-web-app","owner":"thoughtworks","description":null,"archived":false,"fork":false,"pushed_at":"2023-05-01T03:33:26.000Z","size":11183,"stargazers_count":15,"open_issues_count":9,"forks_count":5,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-06-03T23:59:42.471Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thoughtworks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-05-16T11:56:00.000Z","updated_at":"2023-11-30T21:10:46.000Z","dependencies_parsed_at":"2025-05-07T19:34:59.748Z","dependency_job_id":null,"html_url":"https://github.com/thoughtworks/byor-voting-web-app","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/thoughtworks/byor-voting-web-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtworks%2Fbyor-voting-web-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtworks%2Fbyor-voting-web-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtworks%2Fbyor-voting-web-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtworks%2Fbyor-voting-web-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thoughtworks","download_url":"https://codeload.github.com/thoughtworks/byor-voting-web-app/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtworks%2Fbyor-voting-web-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259914867,"owners_count":22931323,"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":"2025-05-07T19:20:54.290Z","updated_at":"2025-06-15T03:02:53.810Z","avatar_url":"https://github.com/thoughtworks.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BYOR-VotingApp [web-app]\n\n[![CircleCI](https://circleci.com/gh/thoughtworks/byor-voting-web-app.svg?style=svg)](https://circleci.com/gh/thoughtworks/byor-voting-web-app) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/) [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n\nWelcome to the main repository for the **BYOR-VotingApp**!\n\nThis repository contains the source code of the **web-app**, if you are looking for information about the **server** component please access [BYOR-VotingApp \\[server\\]](https://github.com/thoughtworks/byor-voting-server) repository. If you want to explore all the setup and deployment options, take a look at [BYOR-VotingApp \\[infrastructure\\]](https://github.com/thoughtworks/byor-voting-infrastructure) one.\n\n#### Table Of Contents\n\n[BUILD YOUR OWN RADAR (aka BYOR)](#build-your-own-radar-aka-byor)\n\n[BYOR-VotingApp](#byor-votingapp)\n-   [Main features](#main-features)\n-   [Running BYOR-VotingApp locally](#running-byor-votingapp-locally)\n-   [Running BYOR-VotingApp on Kubernetes or AWS S3](#running-byor-votingapp-on-kubernetes-or-aws-s3)\n\n[Documentation](#documentation)\n\n[How to contribute to the project](#how-to-contribute-to-the-project)\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"/docs/images/vote_process.gif\" width=\"70%\"\u003e\n\u003c/p\u003e\n\n## BUILD YOUR OWN RADAR (aka BYOR)\nThoughtWorks build its own Technology Radar twice a year.\n\u003e you can find the latest edition [here](https://www.thoughtworks.com/radar).\n\nWe found it so useful that we decided to share the process and build some tools to help every organization run their own radar creation exercise.\n\u003e you can find more information about the process and how the tech radar works [here](https://www.thoughtworks.com/radar/byor).\n\nBuilding your own tech radar, invites you to have a conversation across all organizational levels and review your entire technology portfolio. \n\nThis enables you to:\n- Objectively assess what's working, and what isn't\n- Pollinate innovation across teams and experiment accordingly\n- Balance the risk in your technology portfolio\n- Work out what kind of technology organization you want to be\n- Set a path for future success\n\nThoughtWorks encourage you to run the radar twice a year to keep your organisation aware of the fast changing technologies landscape.\n\n\n## BYOR-VotingApp\n\n### Main features\n\nThe BYOR-VotingApp comes preloaded with around 943 technologies to choose among and 1.860 blips evaluated by ThoughtWorks to compare with, extracted from TW TechRadar Vol1 up to Vol20.\n\nIf you are planning to use the BYOR creation excercise, the BYOR-VotingApp can help you to:\n- [manage one or more BYOR sessions](docs/admin_guide.md#manage-voting-events)\n- load a predefined list of technologies to start with, or use the one already preloaded\n- let people add a new technology if missing\n- [let people vote up to 10 technologies (aka blips)](docs/user_guide.md#vote-for-a-technology)\n- let people write comments about blips\n- :warning: **[*TODO*]** identify technologies where people disagree on rings and a further decision is needed\n- [display the most voted technologies in real-time](docs/admin_guide.md#generate-an-event-word-cloud)\n- [display the final tech radar resulting from the votes collected from the participants of the event](docs/admin_guide.md#generate-an-event-tech-radar)\n- [show, for matching technologies, the ratings coming from the blips collected alognside with the ones published by ThoughtWorks](docs/admin_guide.md#thoughtworks-blips)\n\nAll the Data is stored in a MongoDB database.\n\n### Running BYOR-VotingApp locally\n\n1) install [Docker](https://www.docker.com/get-started)\n1) open the terminal\n1) clone the project\n    ```shell\n    git clone https://github.com/thoughtworks/byor-voting-web-app.git\n    ```\n1) move into the project folder\n    ```shell\n    cd byor-voting-web-app\n    ```\n1) startup web app, server, and a local MongoDB\n    ```shell\n    docker-compose -f docker-compose.all.yml up\n    ```\n1) access the application front-end on [http://localhost:4201](http://localhost:4201)\n\n\u003e if needed, application back-end is accessible on [http://localhost:3001](http://localhost:3001) and application's mongo database is accessible at `localhost:27019`\n\n\u003e Please refer to [CONTRIBUTING.md](CONTRIBUTING.md) for more options on running the web app locally.\n\n\u003e Please refer to [BYOR-VotingApp \\[server\\]](https://github.com/thoughtworks/byor-voting-server) Github repository for more options on running the server locally and connect to a MongoDB database.\n\n### Running BYOR-VotingApp on Kubernetes or AWS S3\n\nPlease refer to [BYOR-VotingApp \\[infrastructure\\]](https://github.com/thoughtworks/byor-voting-infrastructure) Github repository for installing the application on Kubernetes or AWS S3.\n\n## Documentation\n\nIn the docs folder you can find:\n-   a [deck](docs/build_your_own_radar-welcome-deck.pdf\n) to share or present for explaining what the Tech Radar is and how to rate technologies.\n-   the [user guide](docs/user_guide.md)\n-   the [admin guide](docs/admin_guide.md)\n\n## How to contribute to the project\n\nPlease refer to [CONTRIBUTING.md](CONTRIBUTING.md) for all the information about how to contribute.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtworks%2Fbyor-voting-web-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthoughtworks%2Fbyor-voting-web-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtworks%2Fbyor-voting-web-app/lists"}