A modern, full-stack chess application built with React and Node.js, featuring real-time multiplayer gameplay, interactive chessboard with drag-and-drop functionality, and Socket.IO-powered live game sessions. This project combines the classic game of chess with modern web technologies to deliver an engaging gaming experience.
🚀 Key Technologies: JavaScript, React, Vite, ESLint, Node.js, Express.js, Socket.IO, Chess.js, EJS
- 📖 Description
- 🔗 Links
- ⚡ Installation
- 🎮 Usage
- ✨ Features
- 🛠️ Built With
- 📂 Folder Structure
- 🤝 Contributing
- 📄 License
- 🗺️ Roadmap
- 🙏 Acknowledgements
- Node.js (v14 or higher)
- npm or yarn package manager
-
Clone the repository
git clone https://github.com/H0NEYP0T-466/ChessVision.git cd ChessVision -
Install frontend dependencies
npm install
-
Install backend dependencies
cd backend npm install cd ..
-
Start the development servers
Frontend (in one terminal):
npm run dev
Backend (in another terminal):
cd backend node index.js
# Development mode
npm run dev
# Build for production
npm run build
# Lint the code
npm run lint
# Preview production build
npm run preview# Start the application in development mode
npm run dev🎯 Core Features:
- 🚀 Modern Architecture - Built with cutting-edge technologies
- 🎨 Interactive Interface - Responsive and user-friendly design
- ⚡ Real-time Updates - Live functionality and instant feedback
- 🎮 Enhanced User Experience - Smooth and engaging interactions
- 🏁 Robust Functionality - Complete feature set with validation
🔧 Technical Features:
- 📱 Responsive Design - Works seamlessly across all devices
- 🚀 Modern Tech Stack - Built with JavaScript, React, Vite and 6 more
- ♻️ Hot Module Replacement - Fast development with instant updates
- 🎯 Code Quality - ESLint configuration and best practices
- 🎨 Custom Styling - Beautiful, modern UI with custom CSS
ChessVision/
📁 backend/
│ ├── 📁 public/
│ │ └── 📁 js/
│ │ │ └── ⚡ chessgame.js
│ ├── 📁 views/
│ │ └── 📄 app.ejs
│ ├── ⚡ index.js
│ ├── ⚙️ package-lock.json
│ └── ⚙️ package.json
📁 public/
│ └── 📄 vite.svg
📁 scripts/
│ └── 📄 generate-readme.cjs
📁 src/
│ ├── 📁 assets/
│ │ └── 📄 react.svg
│ ├── 🎨 App.css
│ ├── ⚡ App.jsx
│ ├── 🎨 index.css
│ └── ⚡ main.jsx
📖 CONTRIBUTING.md
⚡ eslint.config.js
📄 index.html
📄 LICENSE
⚙️ package-lock.json
⚙️ package.json
📖 README.md
⚡ vite.config.js
We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.
-
Fork the repository
# Click the "Fork" button on GitHub or use CLI gh repo fork H0NEYP0T-466/ChessVision -
Clone your fork
git clone https://github.com/YOUR-USERNAME/ChessVision.git cd ChessVision -
Create a feature branch
git checkout -b feature/amazing-feature
-
Make your changes
- Follow the existing code style
- Add tests if applicable
- Update documentation as needed
-
Commit your changes
git commit -m "Add amazing feature" -
Push to your fork
git push origin feature/amazing-feature
-
Open a Pull Request
- Provide a clear description of your changes
- Reference any related issues
- Ensure all tests pass
- Use meaningful commit messages
- Follow the existing code style
- Test your changes thoroughly
- Update documentation for new features
Found a bug or have a feature request? Please open an issue with:
- Clear description of the problem/feature
- Steps to reproduce (for bugs)
- Expected vs actual behavior
- Your environment details
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2025 ChessVision Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
- Core functionality implemented
- Basic user interface
- Essential features working
- Documentation completed
- Enhanced Features - Additional functionality and improvements
- User Experience - Better interface and user interactions
- Performance - Optimization and speed improvements
- Testing - Comprehensive test coverage
- Documentation - Expanded guides and tutorials
- Advanced Features - Cutting-edge functionality
- Integration - Third-party service connections
- Scalability - Enhanced performance and capacity
- Mobile Support - Native mobile applications
- Analytics - Usage tracking and insights
- 🔥 JavaScript - High-level programming language for web development
- 🔥 React - A JavaScript library for building user interfaces
- 🔥 Vite - Next generation frontend tooling
- 🔥 ESLint - Pluggable JavaScript linter for identifying and reporting patterns
- 🔥 Node.js - JavaScript runtime built on Chrome's V8 JavaScript engine
- 🔥 Express.js - Fast, unopinionated web framework for Node.js
- 🔥 Socket.IO - Real-time bidirectional event-based communication
- 🔥 Chess.js - JavaScript chess library for chess move generation/validation
- 🔥 EJS - Embedded JavaScript templating engine
- Contributors who help improve this project
- The open-source community for inspiration and support
- Users who provide feedback and testing
🎯 Ready to get started?
⭐ Star this repo • 🐛 Report Bug • 💡 Request Feature
Made with ❤️ by H0NEYP0T-466