I Was Overwhelmed, So I Turned My GitHub Profile Into a Roguelike Dungeon

Description and use

The author turned their GitHub profile into a roguelike dungeon using stacked SVG slices and a .NET generator, with daily updates automated via GitHub Actions.

Problem

The author was overwhelmed with a long to‑do list and needed a motivating project to regain momentum.

Outcome

The project transformed the author’s GitHub profile into an engaging roguelike dungeon that visualizes contributions, languages, and pinned repos, while also providing an interactive explore page and daily automated updates.

Workflow

• 1. Designed a README layout using stacked SVG images to form a single console.
• 2. Built a .NET 10 console app (DungeonGen) with renderers for each section (header, dungeon, inventory, quests, about, connect).
• 3. Mapped contribution calendar to dungeon tiles, added night sky and hero path.
• 4. Generated SVGs and updated README blocks via ReadmeUpdater.
• 5. Created an interactive GitHub Pages page for hover tooltips.
• 6. Set up a daily GitHub Action to run the generator and commit changes only when SVGs differ.
• 7. Added cache‑busting query parameters to image URLs to force updates.

Evidence

I started small: a header with a typing animation, built by animating a clipPath width one character at a time.

Source

A GitHub Action runs the generator every day and commits only if something changed:

Source

The generator now adds a hash of each SVG to its URL (dungeon.svg?v=1a2b3c4d), so a changed image gets a new URL.

Source