# Show HN: Codebase Posters – turn any Git repo into generative poster art

> Source: <https://github.com/unable12/codebase-posters>
> Published: 2026-07-12 22:26:14+00:00

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_](https://x.com/unable0_)

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

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

**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.

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.

```
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](https://zehfernandes.com/posts/how-i-turned-world-cup-data-into-posters).
made by [kamil](https://x.com/unable0_). MIT.
