An application that generates embeddable GitHub-style contribution graphs for any repository. Perfect for showcasing your project's activity in README files or documentation.
- Generate GitHub-style contribution graphs for any public repository
- View detailed contribution statistics and metrics
- Real-time data fetching from GitHub's API
- 🖼️ Download contribution graphs as PNG images
- 🔗 Generate shareable links for your contribution graphs
- ReactJS
- A GitHub account (for API access)
- Supabase account (for image storage)
- Fork the repository and clone yours:
git clone https://github.com/your-name/github-repo-contributions-graph
cd github-contributions- Install dependencies:
npm install
# or
yarn install- Create a
.envfile in the root directory and add your environment variables:
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key- Start the development server:
npm run dev
# or
yarn devThe application will be available at http://localhost:5173
- React - Frontend framework
- TypeScript - Type safety
- Tailwind CSS - Styling
- Vite - Build tool
- Supabase - Image storage and caching
- html-to-image - Graph to image conversion
- Enter a GitHub repository URL in the format:
https://github.com/username/repository - Click "Generate Graph"
- View the contribution statistics and graph
- Download the graph as a PNG image or copy the shareable link
- Create a new Supabase project
- Create a new table called
contribution_graphswith the following schema:
create table contribution_graphs (
id text primary key,
owner text not null,
repo text not null,
repository_data jsonb,
contribution_data jsonb,
contributors_count integer,
updated_at timestamp with time zone
);- Add your Supabase URL and anon key to the
.envfile
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the GPL3 License - see the LICENSE file for details.