Chess Royale — HTML5 Chess Game

Chess Royale is a polished, ready-to-publish browser chess game built with pure HTML5, CSS3, and JavaScript. Play against a smart AI opponent, enjoy a beautiful cartoon-style UI, and deploy instantly to any website — no backend, no database, no framework required.

Perfect for game portals, educational sites, portfolios, kids’ websites, or anyone who wants a professional chess experience that works on desktop and mobile.

✨ Key Features

• Full chess rules — check, checkmate, castling, en passant, pawn promotion, stalemate, draws
• AI opponent — Minimax algorithm with Alpha-Beta pruning
• 3 difficulty levels — Easy (Rookie), Medium (Challenger), Hard (Master)
• Time controls — no limit, 10 minutes, or 15 minutes per player
• Play as White or Black
• Elo-style rating system — saved locally for the player
• Hint system — 3 hints per game
• Undo move — once per turn (player move + AI reply)
• Draw offer — AI evaluates and accepts or declines
• Move animations — smooth piece movement
• Legal move highlights — optional dots on valid squares
• Board coordinates — toggle a–h / 1–8 labels
• Flip board — ideal when playing as Black
• Sound effects — move, capture, check, castle, win, lose
• Background music — separate tracks for menu, in-game, victory, and defeat
• Responsive design — optimized for phones, tablets, and desktops
• Web Worker AI — AI thinks without freezing the UI
• Clean, modular code — easy to read, edit, and rebrand

Game Screens

• Loading screen — animated progress bar and logo
• Main menu — difficulty, time, color selection, Play button
• Game screen — player cards, timers, rating, VS badge, chess board, controls
• Promotion modal — choose Queen, Rook, Bishop, or Knight
• Game over modal — result, rating change, Rematch / Main Menu
• Settings modal — sound, animations, hints, coordinates, board flip
• Confirm modals — surrender, leave game, draw offer

What You Get

• Complete game source code (index.html + CSS + JavaScript)
• SVG piece images, UI icons, avatars, and background pattern
• Separate documentation page with full setup and customization guide
• Separate CSS for game and documentation (no style conflicts)
• AI engine with Web Worker support
• Music system (Web Audio — no external audio files required)
• Asset manager with emoji fallbacks if images fail to load

Technical Details

Easy Setup

1. Upload the project folder to your web host or run a local server
2. Open index.html in the browser
3. Tap “Tap to continue” on the loading screen
4. Choose settings and press Play

Local test (Python):
python -m http.server 8080
Then visit: http://localhost:8080

Easy Customization

• Replace piece images in assets/pieces/
• Swap logo and icons in assets/icons/
• Change colors via CSS variables in css/style.css
• Edit AI strength in js/chess-ai.js (depth, rating, name)
• Adjust default settings in js/app.js
• Modify music in js/music.js
• Rebrand title and logo in index.html

Full step-by-step customization guide is included in the documentation file.