Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Maxelweb/workflow-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

17 Commits

Repository files navigation

Workflow Tracker Desktop view

Workflow Tracker

A simple web-hook that shows a real-time branch workflow and the online status of the contributors in a repository

Current version

Version: 1.0.2

Add Dockerfile and docker-compose configuration file. Use docker-compose up -d and docker-compose down -v to run the app through Docker.

Description and Features

This is a simple web app developed in PHP and JS used to track real-time work of the collaborators in a public or private repo.

  • πŸ“± Desktop, Tablet and Mobile view (Bootstrap)
  • πŸ“Š Real-time data check (every 20 seconds)
  • πŸ€™ Github Webhook integration
  • πŸ˜€ User status and current working branch based on push events
  • πŸ“ƒ NO DATABASE needed, just a simple JSON file
  • πŸ“‚ Multiple repositories, one single webhook to point
  • πŸ”Œ Ez install: deploy the webapp, change the config and point the webhook
  • πŸ–οΈ Online update checker

Requirements

  • Apache based web server
  • PHP 7.x
  • One or more public / private Github repo.

Installation

Tip: if you download the source code from the release page, you can deploy the web app without these files: .gitignore, LICENSE, README.md, folders starting with underscore (_folder).

  1. Download the latest release
  2. Change the res/config.php and .htaccess according to your preferences
  3. Insert the files of the downloaded folder in your web space
  4. Point the Github Webhook of your repo to http://your-website.com/res/webhook.php for only push events.
  5. Check the first ping - pong delivery from the Github Webhook page
  6. Done πŸ˜„

Update

Tip: you can check the updates from the updates page link in the navbar

  1. Backup locally the res/data folder, the res/config.php and .htaccess files
  2. Download the latest release
  3. Change the res/config.php and .htaccess according to your old preferences
  4. Replace the res/data folder with your local backup
  5. Done 😁

Stored data

  • The data is stored in the res/data folder via a single JSON file.
  • You will see all the collaborators (after the webhook setup) with at least one push in the repo from any branch.
  • The users and the repos won't be automatically deleted.

Problems or suggestions?

Open a new issue if you have any problem or any suggestion for future updates πŸ™‚

License and Credits

MIT License

Developed by Mariano Sciacco (@Maxelweb)

Thanks for the Github Webhook Handler developed by Miloslav HΕ―la

Support

ko-fi

About

A simple web-hook that shows a real-time branch workflow and the online status of the contributors in a repository

Topics

Resources

License

Stars

Watchers

Forks

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /