https://github.com/midzdotdev/candy
🍬 A React clone of the popular candy / ball sorting puzzle.
https://github.com/midzdotdev/candy
ball-sort-puzzle game react
Last synced: 10 months ago
JSON representation
🍬 A React clone of the popular candy / ball sorting puzzle.
- Host: GitHub
- URL: https://github.com/midzdotdev/candy
- Owner: midzdotdev
- Created: 2024-08-23T16:17:36.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-23T16:28:00.000Z (over 1 year ago)
- Last Synced: 2025-02-15T07:42:16.827Z (12 months ago)
- Topics: ball-sort-puzzle, game, react
- Language: TypeScript
- Homepage: https://candy-eta-three.vercel.app
- Size: 48.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Candy Sort Game
A React-based implementation of the popular Candy Sort puzzle game.
## Description
Candy Sort is a puzzle game where the player must sort candies of different colors into tubes. The goal is to group all candies of the same color together in a single tube. This project implements the game using React and TypeScript, featuring smooth animations and a clean user interface.
## Features
- Interactive gameplay with clickable tubes
- Smooth candy movement animations
- Undo functionality
- New game generation
- Ability to add extra tubes
## Technologies Used
- React
- TypeScript
- CSS
## How to Play
1. Click on a tube to select it.
2. Click on another tube to move the top candy from the selected tube to the target tube.
3. Continue moving candies until all candies of the same color are grouped together in single tubes.
4. Use the "Undo" button to revert moves if needed.
5. Click "New Game" to start a fresh puzzle.
6. Use "Add Tube" to include an empty tube for more strategic options.
## Installation and Running
1. Clone the repository
2. Install dependencies:
```
npm install
```
3. Run the development server:
```
npm start
```
4. Open [http://localhost:3000](http://localhost:3000) in your browser to play the game.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is open source and available under the [MIT License](LICENSE).