Repository navigation
v1.0.0
Summary
🎉 WrapYourGit v1.0.0 is here: the first official release, and the 2026 edition.
WrapYourGit turns your year on GitHub into an animated train ride through a city, guided by Cell. Watch it on the web, then keep it as an MP4, slides or a PDF, all made in your own browser. Try it now at https://wrapyourgit.com with any GitHub username.
Highlights
- The story is a train ride. Cell drives an engine past one square per day and stops at fourteen stations, from your first day to a closing party. Every number is printed on something in the scene (ADR-0023) (#86, #88, #92).
- A recap for every GitHub username at
/<username>, built from public activity only. Signed-in owners see their full recap at the same address and can hide the public one (ADR-0019) (#67). - Exports with no render server. An MP4 in four shapes, a PNG per stop, a ZIP and a PDF are all made in the viewer's browser (ADR-0016) (#56).
- Private by default. Tokens are encrypted at rest and never reach the browser. Public pages never show private counts, and the share card is always the public one (ADR-0017, ADR-0033) (#178).
Added
- The ride: fourteen stations, a gate per month with the year so far, the letter from Cell at a writing desk, and the sound of the rails for every move (#86, #88, #92, #94, #96).
- Exports: MP4 in 9:16, 4:5, 1:1 and 16:9, PNG slides, a ZIP and a PDF, with a percentage and time left while they render (#56, #144).
- Public recaps for any username, with stars gained this year from GitHub's star history and a time budget for heavy accounts (#67, #71).
- Comparison with the same span of last year, private repositories through an optional app installation, and repositories you starred this year (#6, #14).
- Settings: delete my data, sign out on all devices, hide my public recap (#10, #44, #67).
- Cloudflare Turnstile before the server reads a new public recap, and per-IP rate limits on
/apiand/u/(ADR-0026) (#36, #107). - Cloudflare Web Analytics with no cookies, and a nightly encrypted database backup to S3 (#132, #134).
- SEO and sharing: metadata, Open Graph, JSON-LD, sitemap, robots, manifest,
llms.txtand a share card (#12). - An enforced contribution workflow: git hooks, a CI
Policycheck and merge-commit-only settings (ADR-0014) (#28).
Changed
- The site lives at wrapyourgit.com; the old domain redirects there (ADR-0025) (#98).
- Its own warm dark palette and naming, after Chrome and Safe Browsing flagged the site as a look-alike of GitHub. The title leads with WrapYourGit and calls it a GitHub year in review (ADR-0029, ADR-0031) (#139, #153, #163, #189).
- The soundtrack is "Traveling in your mind" by Loyalty Freak Music (CC0), brightened for phone speakers, and six sound effects have more body (ADR-0030) (#155, #159, #161).
- A lighter landing page: one isometric world, a hero with one field and one button (#80, #84, #88, #90, #165, #167).
- Faster public lookups and MP4 exports (#73, #141).
Fixed
- A renamed GitHub login taken by someone else no longer shows the previous holder's public recap (#186).
- Chrome for Android no longer crops the story's sides (#137).
- Both rails and round wheels on the ride (#143).
- A public recap says "Private work isn't shown publicly" instead of "Nothing private this year" (#149).
- A signed-in visitor on someone else's recap goes to their own dashboard after the story (#151).
Removed
- Twelve unused sound effects, about 800 KB less per visitor (#157).
- Vercel Web Analytics, replaced by Cloudflare Web Analytics (#130).
Deprecated
None.
Security
- A Content-Security-Policy allowlist on every page; Remotion's usage ping is blocked (ADR-0034) (#184).
__Host-prefixed, alwaysSecurecookies; Turnstile answers must come from this site's hostname (#180).- Backup image pinned by digest, escaped CI annotations, strict decoding of
TOKEN_ENCRYPTION_KEY(#182). - Public lookups by a signed-in visitor count against their account, not their address (ADR-0032).
- CI checks that a tampered or truncated token never decrypts (#44).
Breaking Changes
None. This is the first release.
Migration / Upgrade Guide
None. This is the first release.
Installation
Use it at https://wrapyourgit.com: type a GitHub username, or sign in to include your private work.
To run it yourself, see "Run it locally" in the README (bun install, then bun run dev) and the deployment guide in docs/deployment/guide.md.
Known Issues
- Exports render in the browser, so the tab has to stay open until the file is done. A 1080p export is slow on phones, where the H.264 encode takes most of each frame.
Full Changelog
First release, no previous tag: https://github.com/habibiahmada/wrapyourgit/commits/v1.0.0