INTERACTIVE September 28, 2026 9 min read CodeCrest Editorial Team

How to Add Playable Interactive Games to GitHub README (Chess & Connect 4)

Direct Answer (TL;DR)

To add playable games like Chess or Connect 4 to your GitHub README, use community actions like MarcusOtter/chess-readme. When a visitor clicks a move link, GitHub opens a pre-filled issue; an automated workflow parses the move, updates the board state, and re-renders the README.

How Issue-Driven State Automation Operates

1. The Move Grid: The README renders a board graphic where each move links to an issue URL. 2. Workflow Trigger: When the issue is submitted, a GitHub Action fires. 3. State Engine: The action validates the move, closes the issue, and commits updated board SVG graphics directly to the README.

Frequently Asked Questions

❓ Will this spam my notifications?

GitHub Actions automatically closes game issues upon processing, and you can route notifications to a dedicated filter.

Build a Visually Stunning GitHub Profile in 60 Seconds

Design Bento grid layouts, verified badges, dynamic memes, and trophies automatically with ProfileCrest.

🚀 Launch Profile Generator Explore Templates →