codebase posters

every repository has a shape. this paints it.

npx codebase-posters

one command, inside any git repo. your browser opens an exhibition: eighteen posters, painted live from your commit history. storms of additions and deletions. your working days as a calendar. the project's heartbeat. the constellations you committed at 2am.

pick one. watch it paint itself. hang it on the wall.

by @unable0_

the gallery

| | | | --- | --- | | react. thirteen years of weather. | express. it's been raining since 2009. | | vite. resting heart rate: not resting. | zod. one man's night sky. | | tailwind. nine years of showing up. | git. the last 20,000 commits. |

each image is a real open-source repo at a fixed seed. same inputs, same pixels.

yours stays yours

runs entirely on your machine. no uploads. no telemetry. no account. 101 kB, zero dependencies. it reads your git log, paints, and forgets.

save it

print: 3600×4800 px. that's 12×16 inches at 300 dpi. real poster, real wall. video: the painting animation as an mp4, encoded in your browser.

every poster is deterministic: same repo, same seed, same pixels.

read it

blue strokes are code arriving. green is code leaving. the dots with dates are your biggest commits. they bend everything around them. each poster explains itself in the gallery.

hacking on it

npm install && npm run dev    # gallery with repo picker (scans ~/code_base)
npm run build                 # dist/app + dist/server.mjs for npx
node bin/cli.mjs              # run the packaged experience locally

add a poster: drop a file in src/recipes/ exporting a CanvasRecipe (src/core/types.ts). it auto-registers.

inspired by zeh fernandes' gencup. made by kamil. MIT.