Skip to content

ShashiShekharDixit/Candy-Crush

Repository files navigation

🍬 Candy Crush Clone

Welcome to the Candy Crush Clone project! This web application recreates the popular Candy Crush game using TypeScript and React, offering an engaging puzzle experience.


🌟 Features

  • Interactive Gameplay: Match candies and crush them to score points.
  • Dynamic Board: Randomly generated candy board with different colors.
  • Level System: Multiple levels with increasing difficulty.
  • Animations: Smooth animations for candy movements and crush effects.
  • Score Tracking: Keep track of player scores and level progression.

🚀 Tech Stack

  • TypeScript: For type safety and enhanced development experience.
  • React.js: For building the user interface and managing state.
  • CSS3: For styling and responsive design.

🎨 Live Demo

Check out the live version of the Candy Crush Clone here (replace with your hosted link).


🛠️ Installation and Setup

Prerequisites

Ensure you have the following installed:

  • Node.js (v14 or later)
  • npm for package management.

Installation Steps

  1. Clone the repository:

    git clone https://github.com/yourusername/candy-crush-clone.git
    cd candy-crush-clone
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm run dev
  4. Build for production: To generate a production-ready build, run:

    npm run build

💻 Usage

Once the project is set up, open your browser and navigate to http://localhost:3000 to play the Candy Crush game.

Customization

  • Add New Levels: Implement additional levels in the src/levels/ directory.
  • Modify Styles: Customize the visual appearance in the src/styles/ directory.
  • Game Logic Adjustments: Update game logic in the src/components/ directory.

📁 Project Structure

📂 candy-crush-clone │ ├── 📂 public/ # Public assets and index.html ├── 📂 src/ # Source code for the app │ ├── 📂 components/ # React components for the game │ ├── 📂 styles/ # CSS styling files │ ├── 📂 levels/ # Level configurations │ └── index.tsx # Main entry point for React ├── .gitignore # Files to ignore in Git ├── package.json # Project dependencies and scripts └── README.md # Project README file


📦 Dependencies

  • React.js: Library for building the user interface.
  • TypeScript: For type safety and improved developer experience.
  • CSS3: For styling the application.

👨‍💻 Contributing

Contributions are welcome! If you'd like to contribute to this project:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature-name).
  3. Commit your changes (git commit -m 'Add some feature').
  4. Push the branch (git push origin feature-name).
  5. Open a pull request and describe your changes!

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.


📞 Contact

If you have any questions or want to connect, feel free to reach out!


Happy Crushing! 🎉

Key Sections:

Features: Overview of the game's functionalities. Tech Stack: Technologies used in the project. Installation: Instructions for setting up and running the project. Usage: How to play the game. Project Structure: Clear organization of the codebase. Contributing: Guidelines for contributors. License and Contact information.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published