Skip to content

parthahuja33/How2Chess

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 

Repository files navigation

How2Chess 🏰♔

A modern, interactive chess learning platform built with React, TypeScript, and Tailwind CSS. Learn chess from beginner to advanced level with interactive lessons, practice puzzles, and AI gameplay.

How2Chess Banner

✨ Features

🎓 Interactive Learning

  • Step-by-step lessons: From basic moves to advanced strategies
  • Progress tracking: Monitor your learning journey
  • Difficulty levels: Beginner, Intermediate, and Advanced content
  • Visual guides: Interactive board demonstrations

🧩 Practice Puzzles

  • Tactical training: Thousands of chess puzzles
  • Themed exercises: Pins, forks, skewers, and more
  • Rating system: Track your puzzle-solving skills
  • Time challenges: Improve your calculation speed

🤖 AI Gameplay

  • Multiple difficulty levels: From beginner-friendly to challenging
  • Real-time analysis: Get insights into your moves
  • Game history: Review and learn from your games
  • Standard chess rules: Full implementation with special moves

🎨 Modern UI/UX

  • Responsive design: Works perfectly on all devices
  • Smooth animations: Powered by Framer Motion
  • Intuitive interface: Clean and user-friendly design
  • Dark/Light themes: Customizable appearance

🚀 Getting Started

Prerequisites

  • Node.js 18.0 or higher
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/how2chess.git
    cd how2chess
  2. Install dependencies

    cd how2chess
    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:3000 to see the application.

Building for Production

npm run build
npm run preview

🏗️ Project Structure

how2chess/
├── src/
│   ├── components/        # Reusable UI components
│   │   └── Navbar.tsx    # Navigation component
│   ├── pages/            # Page components
│   │   ├── Home.tsx      # Landing page
│   │   ├── Learn.tsx     # Learning section
│   │   ├── Practice.tsx  # Puzzle practice
│   │   └── Play.tsx      # AI gameplay
│   ├── types/            # TypeScript type definitions
│   │   └── chess.ts      # Chess-related types
│   ├── assets/           # Images and other assets
│   ├── App.tsx           # Main app component
│   ├── main.tsx          # Entry point
│   └── index.css         # Global styles
├── index.html            # HTML template
├── package.json          # Dependencies and scripts
├── tailwind.config.js    # Tailwind CSS configuration
├── tsconfig.json         # TypeScript configuration
├── vite.config.ts        # Vite configuration
└── README.md             # This file

🛠️ Technology Stack

Frontend

  • React 18 - Modern React with hooks and concurrent features
  • TypeScript - Type-safe JavaScript development
  • Vite - Fast build tool and development server
  • Tailwind CSS - Utility-first CSS framework
  • Framer Motion - Animation library for React

Chess Engine

  • chess.js - Chess game logic and move validation
  • react-chessboard - Interactive chess board component

🎯 Usage Guide

Learning Chess

  1. Navigate to the Learn section
  2. Start with "Chess Basics" for fundamentals
  3. Progress through lessons at your own pace
  4. Complete interactive exercises to reinforce learning

Practicing Puzzles

  1. Go to the Practice section
  2. Filter puzzles by difficulty level
  3. Solve tactical puzzles to improve your skills
  4. Track your rating and progress over time

Playing Games

  1. Visit the Play section
  2. Choose your preferred difficulty level
  3. Play against the AI opponent
  4. Review your games to identify improvements

🤝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License.


Happy Learning! ♔

About

Website to Learn Chess

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •