https://github.com/joyontokarmakar/chess
https://custom-chess-v5.netlify.app/ https://custom-chess-v4-3.netlify.app/ https://custom-chess-v4-2.netlify.app/ https://custom-chess-v4-1.netlify.app/ https://custom-chess-v4.netlify.app/ https://custom-chess-v3.netlify.app/ https://custom-chess-v2.netlify.app/ https://custom-chess-v1.netlify.app/
https://github.com/joyontokarmakar/chess
brainstorming chess-game game multiplayer-game nextjs online-chess puzzle
Last synced: about 2 months ago
JSON representation
https://custom-chess-v5.netlify.app/ https://custom-chess-v4-3.netlify.app/ https://custom-chess-v4-2.netlify.app/ https://custom-chess-v4-1.netlify.app/ https://custom-chess-v4.netlify.app/ https://custom-chess-v3.netlify.app/ https://custom-chess-v2.netlify.app/ https://custom-chess-v1.netlify.app/
- Host: GitHub
- URL: https://github.com/joyontokarmakar/chess
- Owner: Joyontokarmakar
- Created: 2025-06-16T17:28:44.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-07-20T09:41:38.000Z (3 months ago)
- Last Synced: 2025-08-05T18:53:33.311Z (2 months ago)
- Topics: brainstorming, chess-game, game, multiplayer-game, nextjs, online-chess, puzzle
- Language: TypeScript
- Homepage: https://custom-chess-v5.netlify.app/
- Size: 409 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# โ๏ธ Custom Chess Game
A modern, feature-rich, and fully customizable **chess game** built with React, TypeScript, and Tailwind CSS. Play chess **locally with a friend**, **against a smart AI**, or enjoy a **tactics training mode** โ all from your browser. Designed for both beginners and experienced players, this game blends classic chess rules with a sleek, intuitive interface.
## ๐ Live Demo
๐ [Play the Game](#)
(*Replace this with your actual deployed link*)---
## ๐ง Game Modes
- **Player vs AI** โ Choose difficulty: *Easy*, *Medium*, *Hard*, or *Grandmaster*
- **Player vs Player** โ Play with a friend locally on the same device
- **Puzzle Mode / Tactics Trainer** โ Solve chess puzzles to sharpen your skills
- **Simulated Online Mode** โ Share a unique Game ID to play on the same device (not internet multiplayer)---
## ๐น๏ธ Core Gameplay Features
- โ๏ธ **Standard Rules**: Pawn Promotion, Castling, En Passant, Check, Checkmate, and Stalemate detection
- โ **Legal Move Validation**
- ๐ง **AI Engine**:
- Gemini-powered AI (API key required)
- Basic offline fallback AI
- โณ **Timer Mode**
- ๐ **Undo Moves** (optional)
- ๐ก **AI Move Hints** (optional)
- ๐ **Confetti celebration** on checkmate
- ๐ **Game Sounds**: Move, capture, win
- ๐ **Captured Pieces Display**
- ๐ **Smart Toast Notifications**: โCheckโ, โYour Turnโ, โCheckmateโ, etc.
- ๐งญ **In-Game Chess Guide** for beginners and rule refreshers---
## ๐จ Personalization & Themes
- ๐ **Light / Dark Modes**
- ๐จ **Custom Board Styles**: Classic Wood, Cool Blue, Forest Green, etc.
- โ **Multiple Piece Sets**: Default, Staunton, Merida
- ๐๏ธ Rename players mid-game
- ๐งฐ UI Toggle Options:
- Show/Hide Resign, Undo, Hint buttons
- Enable/Disable toast messages---
## ๐ป Progressive Web App (PWA)
- ๐ฒ **Installable App**: Add the chess game to your home screen or desktop for faster access
- ๐ **Offline Play Support**: Fully functional without an internet connection (non-AI modes)
- ๐ฅ๏ธ **Desktop Sidebar Layout**: Quick access to game modes, settings, and navigation---
## ๐งฉ Learn & Improve
- ๐ **Chess Guide**: Piece movement, rules, and strategies built right into the app
- ๐ Visual indicators for:
- Last move made
- Pieces under check
- Available legal moves
- ๐ **Game History & Analysis**: View and analyze your last 10 games move-by-move---
## ๐พ Game Management
- ๐พ **Save/Load Games** using `localStorage`
- ๐ **Hall of Fame**:
- Tracks winners and match info for AI and local games
- Clear history anytime
- ๐ **Start New Game / Reset Options**
- ๐ **Game Menu** with modals and navigational UI
- ๐ **Informational Pages**:
- About the Developer
- Terms & Conditions
- Privacy Policy---
## ๐ Drag & Drop Movement
You can now move pieces by **clicking or dragging** โ your choice! Intuitive controls make it easy for all ages.
---
## ๐ Version Highlights
### ๐ Version 5.0 โ *PWA & UI/UX Enhancements* (2024-08-10)
- โ **Progressive Web App (PWA)**: Install on mobile/desktop for native-like usage
- โ **Offline Mode** for non-AI games
- โ **Desktop Sidebar Layout** for better navigation
- โ **Multiple Piece Sets**: Choose between Default, Staunton, and Merida
- โ **Drag-and-Drop Support** for moving pieces
- ๐ Smoother transitions, improved responsiveness
- ๐ Fixed AI setup and critical UI state error### Version 4.3 โ *Architectural Fixes & UI Enhancements*
- ๐ง Fixed major logic bug in launching game modes
- ๐ Added Multi-Game History + detailed move analysis
- ๐ Added โAbout,โ โTerms,โ and โPrivacy Policyโ pages
- ๐ผ๏ธ Visual polish: Gradient buttons, icon improvements
- ๐ฎ Improved Game Over experience with rematch and return options
- ๐ Puzzle mode bug fixed### Version 4.2 โ *Modern UX Upgrade*
- Welcome screen for new players
- Resign, Undo, Hint buttons improved and repositioned
- Mobile responsiveness upgraded---
## ๐ฑ Responsive Design
- Seamless experience across **desktops**, **tablets**, and **mobile phones**
- Adaptive menus, layouts, and modals for every screen size---
## ๐ Project Structure
```bash
๐ /public
๐ /src
โโโ assets/ # Icons, graphics
โโโ components/ # Reusable React components
โโโ data/ # Chess puzzles, guide content
โโโ utils/ # Game logic, helpers
โโโ App.tsx # Main app entry point