Git Contribution Calendar

A modern web application that visualizes your git contributions across multiple providers (GitHub, Bitbucket) in a unified calendar view.

View Demo · Report Bug · Request Feature

About The Project

Git Contribution Calendar is a powerful tool that aggregates and visualizes your git contributions from multiple providers. Whether you're using GitHub, Bitbucket, or both, this application provides a unified view of your coding activity throughout the year.

Note:

• If you need VPN connection to access Bitbucket, you have to use git-contribution-calendar-ext
  • It uses browser cookies to authenticate and access Bitbucket so you don't need to use Bitbucket access token if you login with Bitbucket account in the browser before using the extension.
• If you don't need VPN connection, you can use git-contribution-calendar-angular
  • It uses .NET Minimal API to access Bitbucket. See more details in the GitContributionCalendar.MinimalAPI repository.

Key Features:

• Multi-provider support (GitHub and Bitbucket integration)
• Interactive contribution heatmap using D3.js
• Contribution statistics and insights
• Multi-language support (English & Turkish)
• Share capabilities

Built With

• 
• 
• 
• 
• 
• 

Getting Started

To get a local copy up and running, follow these steps:

Prerequisites

• Node.js (v18 or higher)
• npm

  npm install npm@latest -g

• Angular CLI

  npm install -g @angular/cli

Installation

1. Clone the repo

   git clone https://github.com/alpvelioglu/git-contribution-calendar-ext.git

2. Install NPM packages for both folders

   cd git-contribution-calendar-ext/angular
   npm install
   cd ..
   cd git-contribution-calendar-ext/chrome
   npm install

Usage

1. Start the development server:

   cd git-contribution-calendar-ext
   npm run start

2. It will create new folder under angular called dist
3. Open your chromium based browser and on the extension page, click on "Load unpacked" button and select the dist folder (You need developer mode enabled in the browser).
4. Click on extension icon and enjoy!

Roadmap

• GitHub Integration
• Bitbucket Integration
• Multi-language Support
• GitLab Integration
• Custom Date Range Selection
• Dark Theme
• Fixing color schema with dynamic colors
• Better UI

See the open issues for a full list of proposed features and known issues.

Contributing

Contributions are welcome! Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.

Contact

[email protected]

Project Link: https://github.com/alpvelioglu/git-contribution-calendar-ext

Acknowledgments

• Angular Material
• D3.js
• Apollo GraphQL
• Tailwind CSS

(back to top)