Repository navigation
Releases
v1.2.0
Summary
WrapYourGit v1.2.0 brings the README card to life: your archetype moves on it the way it does on your dashboard. The card and the snake also drop the username they used to print and lose their rounded corners.
Highlights
- A moving archetype in your README. The card plays the dashboard's own loop of your archetype's diorama, from the same art, in the same place and size as before (ADR-0035 item 11) (#212).
- Cleaner cards. No
@usernameon the card or the snake, since your profile already shows it, and square corners (#214).
Added
None.
Changed
- The README card's archetype moves: a still base and an animated overlay of the parts that move, cropped to the still diorama's box. A reader who asks for reduced motion sees the still diorama. The card grows from about 35 KB to about 150 KB (#212).
- The README card (wide, compact, archetype only) and the snake no longer print the login; the mark and the year sign the header on the left, and the archetype-only card reads "archetype · 2026". The login stays in each image's accessible name and tooltip. Card and snake frames have square corners; the badge keeps its shape (#214).
Fixed
None.
Removed
None.
Deprecated
None.
Security
None.
Breaking Changes
None. README snippets keep working as they are: the same URLs and options.
Migration / Upgrade Guide
None. No database or environment changes. Cards already in a README update on their own within about an hour, as GitHub's image cache expires.
Installation
Use it at https://wrapyourgit.com. A card for your README:
[](https://wrapyourgit.com/<username>)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
- The moving archetype is confirmed in Chromium-based browsers; Firefox, Safari and GitHub's mobile app have not been checked yet. Where an animated image inside an SVG does not play, the archetype may stand still.
- The card's
<picture>snippet switches to the compact layout by screen width; whether GitHub keeps thatmediaquery in every client is not yet confirmed. - Exports still render in the browser, so the tab has to stay open until the file is done.
Full Changelog
v1.1.0
Summary
WrapYourGit v1.1.0 puts your year in your GitHub README. Any username now has a badge, a card and a snake that eats its contribution graph, and downloads open in a preview before they save.
Highlights
- README images for every username. A badge at
/<username>/badge.svg, a card with your archetype at/<username>/card.svgand a snake at/<username>/snake.svg, built from the public recap and never starting a GitHub fetch. The dashboard picks the options and copies the Markdown (ADR-0035) (#194). - Look before you download. Slides, the PDF, the share card and the card with private work open in a preview first; the video still downloads as soon as it is made (#202).
- One product, page to dashboard. The dashboard uses the landing's palette, 12 px boxes and isometric floor, and every dialog fades in instead of appearing at once (#200, #202, #204, #206).
Added
- README images: a badge with the year and up to four values (
?show=), a card with the archetype's diorama (?archetype=left|right,?hide=,?show=graph,?layout=compactfor phones) and a snake that grows as it eats your graph; reduced motion shows them still (#194). - "Put it in your README" on the dashboard, and a README section on the landing page with the compact card on phones (#194).
- The landing page's story frames open larger over a dark overlay, with previous and next, arrow keys and Escape (#200).
Changed
- Slides, the PDF and both cards open in a preview before they download; closing it drops the file (#202).
- The dashboard matches the landing page: palette tokens instead of blue, amber and typed-out greens, green links, 12 px boxes and a faint isometric floor (#204, #206).
- The site's description, keywords, structured data, FAQ and
llms.txtdescribe the README images, and the repository README shows them (#208).
Fixed
- Exported slides (PNG, ZIP, PDF) and the landing page's frames no longer carry the story's progress bar, which read as a loading line on a single frame (#198).
- The dashboard's "You can sync again at" time no longer causes a hydration mismatch: it reads in UTC until the browser's timezone is known (#196).
Removed
None.
Deprecated
None.
Security
None. The README images read only the stored public recap, the same data as /<username>, so private work and hidden accounts stay out of them.
Breaking Changes
None.
Migration / Upgrade Guide
None. No database or environment changes. Self-hosters deploy as usual.
Installation
Use it at https://wrapyourgit.com. To put your year in a README, add:
[](https://wrapyourgit.com/<username>)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
- The card's
<picture>snippet switches to the compact layout by screen width; whether GitHub keeps thatmediaquery in every client is not yet confirmed. The plain Markdown snippet always works. - README images under
/u/<reserved name>fall under the per-IP rate limit of/u/. - Exports still render in the browser, so the tab has to stay open until the file is done.
Full Changelog
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