https://github.com/fresh-milkshake/chess-zoo

Chess Zoo Sim
https://github.com/fresh-milkshake/chess-zoo

chess simulation

Last synced: about 1 month ago
JSON representation

Chess Zoo Sim

• Host: GitHub
• URL: https://github.com/fresh-milkshake/chess-zoo
• Owner: fresh-milkshake
• License: mit
• Created: 2025-05-05T21:32:17.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-06T21:22:32.000Z (12 months ago)
• Last Synced: 2025-07-06T22:27:58.830Z (12 months ago)
• Topics: chess, simulation
• Language: JavaScript
• Homepage: https://fresh-milkshake.github.io/chess-zoo/
• Size: 2.46 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Chess Zoo Web Application

[![Deploy to GitHub Pages](https://github.com/fresh-milkshake/chess-zoo/actions/workflows/deploy.yml/badge.svg)](https://github.com/fresh-milkshake/chess-zoo/actions/workflows/deploy.yml)

A web simulation of the "Chess Zoo" concept, where various chess pieces move around in their enclosures separated by walls, fully inspired by the [xkcd "Chess Zoo"](https://imgs.xkcd.com/comics/chess_zoo.png) comic.

Link to running gh-pages: https://fresh-milkshake.github.io/chess-zoo/

The application includes:

- Movement of chess pieces according to the rules

- Walls and enclosures loaded from a customizable PGN-like format

- Interactive chess board and tools for customizing the zoo

- Visitors who can observe the chess pieces and comment on what they see

## Installation and Running

```bash

npm install

npm start

```

> The simulation will automatically open in your browser at:

> http://localhost:3000

## Technical Details

The application is built using:

- React for the user interface

- Canvas API for rendering the board and pieces

- Custom hooks for state management

- Modular project structure for logic separation

### Main Components

- `ChessZooApp` - Root application component

- `ChessZooBoard` - Chess board component with Canvas

- `ControlPanel` - Control panel with tools

- `useBoardInteractions` - Hook for handling board interactions

- `useChessZooState` - Hook for managing application state

### License

This project is distributed under the MIT License. See the [LICENSE](LICENSE) file for more information.