🎮 ClaudeGames

71 handmade HTML5 games in a console-style storefront — free, instant, no installs, no accounts.

✨ Highlights

• 71 games across Arcade, Action, Puzzle, Board & Card, Sports and Adventure — from Snake, Tetris and Pinball to Solitaire, Mahjong, Sudoku and Nine Men's Morris
• Console-store portal — cinematic featured carousel, horizontal game shelves, box-art covers, instant search (/) and category filters
• Polished visuals — glowing particles, screen shake, score popups, beveled sprites, felt card tables and wooden boards, all drawn in code
• Progress that sticks — high scores, favorites, "continue playing", stats page and 19 achievements, saved in your browser
• Sound & music — every effect and the chiptune soundtrack are synthesized live with WebAudio; no audio files
• Mobile-ready — touch controls, swipe gestures and layouts tested down to 356px
• Zero dependencies at runtime — static files you can host anywhere

🚀 Play locally

git clone https://github.com/ThVerg/ClaudeGames.git
cd ClaudeGames
python3 -m http.server 8765
# open http://localhost:8765

Any static server works (npx serve, nginx, GitHub Pages…). Opening index.html straight from disk also mostly works, but a local server is recommended for iframes and storage.

📸 Screenshots

🕹️ The games

All 71 games (click to expand)

Game	Type	Controls
Neon Snake	Arcade	Arrows / WASD / swipe
Brick Breaker	Arcade	Mouse / arrows
Star Blaster	Action	Move + Space fire
Sky Hopper	Arcade	Space / tap
Memory Flip	Board & Card	Click cards
Block Drop	Puzzle	Arrows + Space
Neon Pong	Sports	Mouse / W S
Merge 2048	Puzzle	Arrows / swipe
Whack-a-Bot	Action	Click / tap
Fruit Catch	Arcade	Move basket
Asteroid Run	Action	Dodge left/right
Color Gate	Arcade	Tap to switch color
Bubble Pop	Puzzle	Aim & shoot
Maze Dash	Adventure	Arrows / swipe
Reaction Rush	Action	Click targets
Pixel Jump	Adventure	Move + jump
Sky Climb	Adventure	Steer left/right, bounce up
Road Rush	Arcade	Hop across traffic
Echo	Puzzle	Repeat the glowing pattern
Minefield	Puzzle	Reveal cells, flag mines
Stack Tower	Arcade	Tap to drop blocks
Tic-Tac-Bot	Board & Card	Click a square
Word Rush	Puzzle	Type words from six letters
Orb Defense	Action	Build towers, survive 10 waves
Dot Muncher	Arcade	Eat dots, dodge ghosts
Four in a Row	Board & Card	Click a column
Air Hockey	Sports	Slide your mallet
Slide 15	Puzzle	Slide tiles into order
Lights Out	Puzzle	Tap to darken the board
Rock Storm	Action	Rotate, thrust, fire
Star Shield	Action	Click to intercept missiles
Five Guess	Puzzle	Type five-letter guesses
Sudoku	Puzzle	Tap cell + number
Balloon Words	Puzzle	Guess letters
Reversi	Board & Card	Click to outflank
Type Storm	Action	Type words fast
Tank Duel	Sports	2-player tank battle
Gem Swap	Puzzle	Swap gems, match three
Pixel Runner	Arcade	Jump and duck
Snake Wars	Sports	2-player snake duel
Nonogram	Puzzle	Fill by number clues
Box Pusher	Puzzle	Push crates onto pads
Code Breaker	Puzzle	Crack the 4-color code from peg feedback
Tower Shift	Puzzle	Tower of Hanoi, 3–5 discs
Peg Solitaire	Board & Card	Clear the cross board to one peg
Word Search	Puzzle	Find six hidden words per round
Dots & Boxes	Board & Card	Pencil duel vs a chain-savvy bot
Battleship	Board & Card	Sink the bot's hidden fleet
Blackjack	Board & Card	Run your chip stack against the dealer
Checkers	Board & Card	Full draughts vs the bot, kings and chains
Solitaire	Board & Card	Classic Klondike, tap to auto-move
Dice Five	Board & Card	Yahtzee-style 13-turn dice strategy
Mahjong Solitaire	Board & Card	Clear the tile pyramid, always solvable
Video Poker	Board & Card	Jacks or Better, chase the royal
Neon Bowling	Sports	Ten frames, timing-based, perfect 300
Neon Flow	Puzzle	Connect the dots, fill the grid
Gomoku	Board & Card	Five in a row vs a sharp bot
Number Recall	Puzzle	Flash-memory circles, tap in order
Neon Pinball	Arcade	Bumpers, flippers, three balls
Ultimate Tic-Tac-Toe	Board & Card	Nine boards, one meta-war
Spider Solitaire	Board & Card	One-suit spider, eight runs to win
FreeCell	Board & Card	All face-up, four cells, pure skill
Quiz Blitz	Puzzle	Rapid trivia, three strikes out
Mini Golf	Sports	Nine greens, drag to putt
Traffic Jam	Puzzle	Slide the gridlock, free the red car
Dominoes	Board & Card	Draw dominoes vs the bot
Matchstick Duel	Board & Card	Nim — last stick wins
Word Ladder	Puzzle	One letter per rung, real words only
Crazy Eights	Board & Card	Shed your hand — wild eights call the suit
Mancala	Board & Card	Sow seeds, chain free turns, raid the far pit
Nine Men's Morris	Board & Card	Close mills, capture, fly when down to three

🧱 Project layout

index.html          # Storefront: carousel, shelves, library
play.html           # Game player (iframe) with fullscreen, favorites, share, sound toggles
stats.html          # Your scores, milestones and achievements
css/style.css       # Portal design system
css/game-common.css # Shared in-game chrome (HUD, overlay, stage)
js/catalog.js       # Game metadata (title, category, colors, controls…)
js/app.js           # Portal logic
js/game-kit.js      # Shared game helpers: canvas fitting, particles, FX, WebAudio sfx + music
games/*.html        # 71 self-contained games — one file each
thumbs/*.png        # Gameplay screenshots used as cover art
tools/              # QA + asset scripts (Playwright)

Adding a game

1. Create games/<id>.html — copy any existing game for the HUD / overlay / GameKit.bindStart() skeleton.
2. Register it in js/catalog.js (id, title, category, description, controls, color, emoji, difficulty).
3. Capture its cover: node tools/capture-thumbs.js with ONLY=<id>.

🧪 Testing

The tools/ folder has a Playwright-based QA suite (dev-only; cd tools && npm install):

Command	What it checks
node tools/smoke.js	Every page loads with zero console errors; portal pages fit a 360px phone
node tools/behave.js	76 gameplay scenarios driven through each game's ?debug=1 hooks
node tools/fuzz.js	Random-input fuzzing of every game (FUZZ_SECONDS, ONLY=)
node tools/capture-thumbs.js	Regenerates the cover art by playing each game headlessly

Serve the site on port 8765 first. See tools/README.md for details.