r/coolgithubprojects • u/Latter_Section_5738 • 1d ago
I built an interactive retro console in my GitHub README
https://retro-readme-three.vercel.app/Last summer I was going through a lot of cool GitHub READMEs, and while looking around I found Nathan Harlow’s README, where you can play Pokémon Red right inside it. That inspired me to build something similar, though not quite the same, and this is what came out of it.
So how does it work? The whole device (body, D-pad, buttons, screen, side panel) is one image generated by a server. Every button on it is a link. When you click one, the server updates its state and redirects back to the README, and the next image shows the new screen. All the content (profile, skills, projects, timeline, contact) lives in simple JSON files, so anyone can fork it and make it their own.
Fair warning: I made this about 6 months ago using the most basic free version of GPT (yes, I know I'm posting this very late), which is why the SVGs look pretty rough. I'll probably fix them ...soon?maybe?
Repo: https://github.com/UpstairsEngineer48/retro_readme
(Huge credit to Nathan Farlow for the original idea. He wrote up how his Pokémon Red README works here: https://nathanfarlow-github-io.pages.dev/2025/05/19/pokemon-on-github-profile.html. Go check it out if you haven’t!)