GitHub Value is a free and open-source application designed to help measure the adoption, value, and impact of GitHub features.

Core Features

• GitHub Copilot usage analytics and metrics
• Developer engagement tracking
• Light/Dark theme support
• Responsive Material Design UI

---

Deployment

Docker Compose

Install docker compose and run one command.

docker-compose up

Heroku

You can deploy the application to Heroku using the Heroku CLI.

WARNING: Deploying to Heroku will cost you about $17/month.

Login, create a new app, and deploy the application.

heroku login

# If new app, create it
heroku create your-app-name

# Set stack to container
heroku stack:set container -a your-app-name

# Push and deploy
git push heroku main

# Check the logs
heroku logs --tail

# Check the status of the app
heroku ps

# Open the app in the browser
heroku open

The first time you visit the app it will walk you through creating the GitHub App in your organization.

You will need to manually add the config vars to the Heroku app. You can also edit config vars from your app’s Settings tab in the Heroku Dashboard.

# Set all config vars
heroku config:set GITHUB_APP_ID="1234567"
heroku config:set GITHUB_APP_INSTALLATION_ID="12345678"
heroku config:set GITHUB_APP_PRIVATE_KEY="$(cat path/to/secret.key)"
heroku config:set GITHUB_WEBHOOK_SECRET="secret"
heroku config:set WEBHOOK_PROXY_URL="https://smee.io/123" # You can get this URL from your app after it starts
heroku config:set BASE_URL="https://octodemo-9e26d32b64b8.herokuapp.com" # This is the URL of your Heroku app

# Verify that the config vars are set correctly
heroku config

# Restart the app
heroku restart -a app_name

---

Development

Tip

This repository is Codespaces and DevContainers ready! Just open the repository in GitHub Codespaces or in Visual Studio Code and you're good to go! 🚀

Pre-requisites:

• Docker and Docker Compose
• Node.js 23+ (for local development)
• Angular CLI (npm install -g @angular/cli)

VSCode Task

You can start the Develop task by pressing Ctrl+Shift+B or running Run Task from the global Terminal menu.

Right click the terminal sidebar and click Unsplit terminal if you're lacking space to view them side by side.

Manual

Start up the database. It's defined in the docker-compose.yml file.

docker-compose up -d db

Then, you can run the server and the client separately.

cd backend
cp .env.example .env  # Configure your env variables
npm install
npm run dev

cd frontend
npm install
npm run start

Congratulations! You now have a fully functioning development environment! 🧑‍💻

Contributing

Feel free to submit issues or pull requests! Contributions are welcome! 🤗

---

License

This project is licensed under the MIT License. See the LICENSE file for details.