Skip to main content

​
Create Your First Wrapped

Get started with GitHub Wrapped in just a few clicks. No installation required - just visit the app and start exploring!
1

Visit GitHub Wrapped

Navigate to the GitHub Wrapped application in your browser. You’ll see a clean interface with a search input and year selector.
The app works on any device - desktop, tablet, or mobile!
2

Enter a Repository

In the repository input field, enter a GitHub repository in one of these formats:
  • owner/repo format: facebook/react
  • Full GitHub URL: https://github.com/vercel/next.js
Signed in users can select from a dropdown of their own repositories, including private ones. Public repositories work for everyone!
The app will validate the repository in real-time to ensure it exists and is accessible.
3

Select a Year

Choose any year from 2008 to the current year using the year selector dropdown.Pick a year when the repository was active to see the most interesting data!
For most active repositories, the previous year or current year will have the most complete data.
4

Generate Your Wrapped

Click the GO button to start generating your wrapped.The app will:
  1. Validate your repository
  2. Fetch data from the GitHub API
  3. Calculate comprehensive analytics
  4. Generate your animated story
First-time generation: 5-10 seconds for small-to-medium repos
Cached results: Under 3 seconds (cached for 24 hours)
5

Explore Your Story

Navigate through the slides using:
  • Arrow keys (← →) on desktop
  • On-screen buttons on any device
  • Spacebar to auto-play through all slides
Each wrapped story includes 8-12 slides featuring:
  • Welcome screen with repository info
  • Total commits and basic stats
  • Top contributor spotlight
  • Community growth metrics
  • Busiest month analysis
  • Language breakdown
  • Major releases (if applicable)
  • Night owl and weekend warrior patterns
  • Complete year summary
  • Sharing options
6

Share Your Wrapped

On the final slide, you can:
  • Share on Twitter - Pre-filled tweet with your wrapped link
  • Copy link - Share the URL anywhere
  • Generate a new wrapped - Try another repository or year
Every wrapped has a unique shareable URL like:
/wrapped/owner/repo/2024
Not sure where to start? Try generating a wrapped for these popular repositories:

React

facebook/react - See how the world’s most popular UI library evolved

Next.js

vercel/next.js - Explore the React framework’s journey

TypeScript

microsoft/typescript - Dive into TypeScript’s development

VS Code

microsoft/vscode - The editor millions use daily

​
User vs Repository Wrapped

GitHub Wrapped supports two types of wrapped stories:

​
Repository Wrapped

Analyzes a specific repository to show:
  • Repository-wide commit activity
  • All contributors and their impact
  • Community growth (stars, forks, contributors)
  • Release history and milestones
  • Language statistics
Use case: Team retrospectives, open source project summaries, celebrating milestones

​
User Wrapped

Focuses on an individual GitHub user to show:
  • Personal contribution patterns
  • Most active repositories
  • Coding time preferences
  • Language preferences
  • Contribution streaks
Use case: Personal year-in-review, developer portfolios, team member spotlights
To generate a User Wrapped, enter just the username (not owner/repo) in the repository input field.

​
Sign In for More Features

While GitHub Wrapped works great without signing in, authenticated users get:
Generate wrapped stories for your private repositories and organizations.
Quick-select from a dropdown of all your repositories instead of typing manually.
5,000 API requests per hour instead of 60 - generate more wrappeds without hitting limits.

​
Keyboard Shortcuts

Make navigation even faster with keyboard shortcuts:
KeyAction
→Next slide
←Previous slide
SpaceToggle auto-play

​
Understanding the Analytics

Here’s what each slide shows:
Repository name, description, and year overview
Total commits, contributors, stars gained, issues closed, and PRs merged
Spotlight on the top contributor by commit count with their contribution percentage
New stars, new forks, new contributors - showing how the community expanded
The month with the most commits, showing peak activity periods
Breakdown of programming languages used in the repository with percentages
Significant version releases published during the year
Night owl percentage (commits after 8 PM) and weekend warrior stats
Complete overview combining all key metrics in one comprehensive view

​
Next Steps

Explore Features

Learn about all the analytics and visualizations available

API Reference

Build your own integrations using the GitHub Wrapped API

Setup Guide

Run GitHub Wrapped locally for development or self-hosting

Share Your Wrapped

Learn the best ways to share your wrapped stories
Pro tip: Generate wrappeds for multiple years of the same repository to see how it evolved over time!

Build docs developers (and LLMs) love

Get started for freeTalk to us