Chess Cage is a React-based chess learning platform built with Vite. It combines interactive board play, chess lessons, drills, and puzzle training in a single experience for players who want to improve their understanding of the game.
- Play chess against a board interface with move handling and game state support
- Explore structured chess lessons covering core topics such as pawns, knights, bishops, rooks, queens, promotion, stalemate, material, mutual agreement, and the king
- Practice through drills and a dedicated puzzle trainer experience
- Access tools such as a board editor and analysis-oriented views
- Use authentication flows powered by Firebase and Supabase integrations
- React 19
- Vite
- React Router
- chess.js
- react-chessboard
- Firebase and Supabase
- Vitest and Testing Library
- src/components — reusable UI pieces such as the navbar, board, panels, and inputs
- src/views — route-level pages for home, play, lessons, puzzles, login, signup, and settings
- src/helpers — utility functions for move formatting, puzzle generation, and rating logic
- src/firebase and src/supabase — integration points for authentication and backend services
- Node.js 18 or newer
- npm
npm installRun the app locally:
npm run devThen open the local Vite URL shown in the terminal.
Create a production build:
npm run buildRun the test suite:
npm testnpm run lintThe project is configured with a GitHub Pages homepage entry in package.json, so it can be deployed using a standard Vite static hosting workflow.
This project includes Firebase and Supabase setup files, so authentication and data-backed features may require the appropriate API configuration in your local environment.
No license has been explicitly declared for this project yet.