Your year in code, beautifully wrapped.
GitWrapped transforms a developer's public GitHub activity into a beautiful, story-driven annual recap.
Instead of overwhelming users with dashboards and endless statistics, GitWrapped presents a cinematic experience that highlights coding habits, milestones, achievements, and insights through immersive storytelling.
GitWrapped is built around one simple idea:
Every developer has a story. GitWrapped helps tell it.
The goal is not to build another GitHub analytics website.
The goal is to create an experience people genuinely enjoy sharing :).
- Story-driven annual recap
- Interactive full-screen slides
- Smooth page transitions
- Mobile-first experience
- Shareable recap pages
- Commit activity
- Contribution streaks
- Language insights
- Repository highlights
- Contribution timeline
- Coding hour analysis
- Weekly activity patterns
- Longest coding streak
- Biggest coding day
- Repository statistics
- Year overview
- Coding consistency
- Favorite repositories
- Language evolution
- Development milestones
- Personal achievements
- Year-end summary
- Public recap URLs
- Social sharing
- Downloadable recap cards
- Replay mode
- Next.js 15
- React 19
- TypeScript
- Tailwind CSS v4
- Framer Motion
- shadcn/ui
- TanStack Query
- Zod
- GitHub GraphQL API
- Lucide React
- Vercel
GitWrapped follows a strict design philosophy.
- Dark mode only
- Montserrat as the only application font
- Storytelling over dashboards
- Clean, premium interfaces
- Motion with purpose
- Minimal visual noise
- No unnecessary UI decoration
Every screen should feel intentional.
GitWrapped/
├── app/
├── components/
├── features/
├── services/
├── hooks/
├── lib/
├── providers/
├── styles/
├── types/
├── utils/
├── constants/
├── config/
└── public/
The architecture is designed for long-term maintainability and future expansion.
- Project architecture
- Design system
- Landing page
- GitHub integration
- Story engine
- Analytics generation
- Animated recap
- Share pages
- Export features
- Replay mode
- Performance optimization
- Accessibility improvements
- Multi-year comparisons
- LeetCode integration
- Codeforces integration
- WakaTime integration
- Developer profile history
Clone the repository.
git clone https://github.com/<your-username>/gitwrapped.git
cd gitwrappedInstall dependencies.
npm installStart the development server.
npm run devPlease read the project's CONTRIBUTING.md before opening an issue or submitting a pull request.
This project will be released under the MIT License.
Built with care by Pratham.
GitWrapped is an independent open-source project and is not affiliated with GitHub.