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-angular.git

2. Install NPM packages

   npm install

3. Populate the src/proxy.conf.json file, because using localhost will block some Bitbucket endpoints due to CORS policy.

   {
        "/rest/": {
        "target": "YOUR_BITBUCKET_URL",
        "secure": false,
        "changeOrigin": true
        },
        "/plugins/servlet/": {
        "target": "YOUR_BITBUCKET_URL",
        "secure": false,
        "changeOrigin": true
        }
    }

4. In alternative way for proxy.conf.json, you can run this app with .NET backend from the repository Git Contribution Calendar Minimal API.

Usage

1. Start the development server:

   ng serve

2. Open your browser and navigate to http://localhost:4200
3. Connect your GitHub and/or Bitbucket accounts
4. View your unified contribution calendar!

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

aeren53.ae@gmail.com

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

Acknowledgments

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

(back to top)