Showcase your 2025 GitHub contributions with a polished, customizable year-in-review card - themeable, concise, and ready to share.
Create a polished year-in-review card for your GitHub contributions and share it with your network.
Live : https://gitwrap-2025.vercel.app
- Personalized Stats: Commits, PRs, Issues, and Reviews aggregated into one card.
- Multiple Themes: Choose from several visually appealing layouts and color schemes.
- Shareable Export: Export your card as an image for LinkedIn, Twitter, or personal sites.
- Fast & Lightweight: Built with Vite + React and TypeScript for snappy UX.
- AI (Text Only): Uses Gemini API for text generation.
These steps get you running locally for development and testing.
- Node.js (v18+ recommended)
npmoryarn
- Clone the repo:
git clone https://github.com/aftab-s/gitwrap-2025.git
cd gitwrap-2025- Install dependencies:
npm install- Add environment variables by creating a
.env.localfile in the project root:
VITE_GEMINI_API_KEY=your_google_gemini_api_key
VITE_GITHUB_APP_TOKEN=your_github_personal_access_token- Run the dev server:
npm run devThe development server runs on http://localhost:3000 — open that URL after starting the server.
src/— React components and app logicpublic/images/— banner and imagery used in the README and appapi/— serverless endpoints
- Try different themes in the app to find the best contrast for sharing on social.
- Use the
Exportoption to download a image.
Contributions are welcome. Open an issue for discussion or submit a PR with your changes.
Short checklist for PRs:
- Update or add tests if applicable
- Keep changes focused and documented
Built by the GitWrap contributors. Hosted on Vercel: https://gitwrap-2025.vercel.app
This project is built and maintained by our amazing contributors. Thank you for your contributions!
Happy wrapping! 🎁