|
1 | 1 | # GithubFlareStats
|
2 |
| -GithubFlareStats is an open-source tool that generates dynamic, customizable images showcasing GitHub user statistics. With support for customizable themes, it allows developers to easily embed personalized stats into their GitHub profile README, providing a visually appealing way to display stars, commits, PRs, issues, and more. |
| 2 | + |
| 3 | + |
| 4 | + |
| 5 | +## About |
| 6 | + |
| 7 | +**GithubFlareStats** is an open-source tool designed to generate dynamic, customizable images for displaying GitHub user statistics. It supports multiple themes and allows you to embed these stats into your GitHub profile README or any other markdown-supported platform. Display stars, commits, pull requests, issues, and much more in a visually appealing format. |
| 8 | + |
| 9 | +## Table of Contents |
| 10 | + |
| 11 | +- [About](#about) |
| 12 | +- [Features](#features) |
| 13 | +- [Live Demo and Examples:](#live-demo-and-examples) |
| 14 | + - [Customization](#customization) |
| 15 | + - [Customization](#customization) |
| 16 | + - [Examples URLs](#examples-urls) |
| 17 | +- [Usage](#usage) |
| 18 | +- [Technology Stack](#technology-stack) |
| 19 | +- [Contributing](#contributing) |
| 20 | +- [Acknowledgments](#acknowledgments) |
| 21 | +- [License](#license) |
| 22 | +- [Contact](#contact) |
| 23 | + |
| 24 | +## Features |
| 25 | + |
| 26 | +- **Display GitHub Stats**: Showcase total stars, commits, PRs, issues, discussions, followers, and contributions. |
| 27 | +- **Customizable Themes**: Modify background, text, and card colors via URL parameters to match your profile style. |
| 28 | +- **Embed-Friendly**: Supports markdown embedding for GitHub profile readme files and other markdown-supported platforms. |
| 29 | +- **Responsive**: Dynamically adjusts to different screens and usage contexts. |
| 30 | + |
| 31 | + |
| 32 | + |
| 33 | + |
| 34 | +## Live Demo and Examples: |
| 35 | + |
| 36 | + |
| 37 | + - **Light Mode - Live:** |
| 38 | + -  |
| 39 | + |
| 40 | + |
| 41 | + - **Dark Mode - Live:** |
| 42 | + -  |
| 43 | + |
| 44 | +### Customization |
| 45 | + |
| 46 | +| Parameter | Description | |
| 47 | +| --- | --- | |
| 48 | +| bgColor | Background color (e.g., #ffffff) | |
| 49 | +| textColor | Text color (e.g., #000000) | |
| 50 | +| cardColor | Card background color (e.g., #e1e1e1) | |
| 51 | +| chartColor | Color for chart bars (e.g., #007bff) | |
| 52 | +| chartTextColor | Text color for chart labels (e.g., black) | |
| 53 | + |
| 54 | + |
| 55 | +### Examples URLs |
| 56 | + |
| 57 | + - **Embed Light Mode Example:** |
| 58 | + ```md |
| 59 | +  |
| 60 | + |
| 61 | + ``` |
| 62 | + - **Embed Dark Mode Example:** |
| 63 | + ```md |
| 64 | +  |
| 65 | + ``` |
| 66 | + |
| 67 | + |
| 68 | +## Usage |
| 69 | + |
| 70 | +1. Replace ajee10x with your GitHub username in the demo URL: |
| 71 | + ```md |
| 72 | + ) |
| 73 | + ``` |
| 74 | +2. Paste this link into your README or any markdown-supported content to showcase your GitHub stats. |
| 75 | + ```md |
| 76 | + ![GitHub Stats]) |
| 77 | + ``` |
| 78 | + |
| 79 | + |
| 80 | +## Technology Stack |
| 81 | +- Backend: Python (Flask for serving the image generation) |
| 82 | +- Frontend: HTML, CSS, JavaScript (for theme preview and demo page) |
| 83 | +- Image Processing: Pillow (Python Imaging Library) |
| 84 | +- Data Caching: Implemented to reduce API calls and cache images for 24 hours. |
| 85 | +- Proxy: PHP used as a lightweight proxy to route requests and manage caching. |
| 86 | +- Hosting: Deployed to a production-ready hosting environment. |
| 87 | + |
| 88 | +## Contributing |
| 89 | + We welcome contributions! Here's how you can help: |
| 90 | + |
| 91 | + 1. Give the project a STAR. |
| 92 | + 2. Follow us on Github. |
| 93 | + 3. Follow us on Social Media. |
| 94 | + 4. Fork the repository. |
| 95 | + 5. Create a new branch for your feature or bug fix. |
| 96 | + 6. Make your changes. |
| 97 | + 7. Submit a pull request. |
| 98 | + 8. Please make sure to update tests as appropriate. |
| 99 | + |
| 100 | + |
| 101 | +## Acknowledgments |
| 102 | +- Python: The programming language used for the backend of this project. |
| 103 | +- Pillow: For enabling image manipulation and rendering in Python. |
| 104 | +- GitHub API: For providing the data used in generating user stats. |
| 105 | +- Stats are updated every 24 hours automatically to prevent excessive API requests and to ensure that the service remains efficient and avoids hitting rate limits. |
| 106 | +- All Contributors: Thanks to everyone who contributed to the project. |
| 107 | +- OpenLabX Team: Special thanks to the team for developing and maintaining the project. |
| 108 | + |
| 109 | +## License |
| 110 | +This project is licensed under the [MIT license](LICENSE). |
| 111 | + |
| 112 | +## Contact |
| 113 | + |
| 114 | +In pursuit of innovation, |
| 115 | +**OpenLabX Team** |
| 116 | + |
| 117 | +- **Website**: [https://openlabx.com](https://openlabx.com) |
| 118 | + |
| 119 | + |
| 120 | +**Follow Us:** |
| 121 | + |
| 122 | +- [Instagram](https://www.instagram.com/openlabx_official/) |
| 123 | +- [X (formerly Twitter)](https://x.com/openlabx) |
| 124 | +- [Facebook](https://www.facebook.com/openlabx/) |
| 125 | +- [YouTube](https://www.youtube.com/@OpenLabX) |
| 126 | +- [GitHub](https://github.com/openlab-x) |
0 commit comments