Skip to content

🍬 A React clone of the popular candy / ball sorting puzzle.

Notifications You must be signed in to change notification settings

midzdotdev/candy

Repository files navigation

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 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.

About

🍬 A React clone of the popular candy / ball sorting puzzle.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published