Spring Festival Crush - Match 3

🎮 Demo

Overview

Spring Festival Crush - Match 3 is a vibrant match-3 puzzle game that captures the essence of the Spring Festival. Immerse yourself in a world filled with festive joy, challenging puzzles, and stunning graphics that celebrate the season.

✨ Features

• 🎉 Festive Theme: Dive into the spirit of the Spring Festival with themed levels and elements that bring the celebration to life.
• 🧩 Challenging Gameplay: Overcome a variety of levels that increase in difficulty, offering endless fun and a test of your puzzle-solving skills.
• ⚡ Smooth Experience: Enjoy fluid animations and intuitive controls for a seamless gaming experience.
• 🎵 Immersive Audio: Experience traditional Chinese music and sound effects that enhance the festive atmosphere.
• 🌟 Multiple Zodiac Themes: Play through different Chinese zodiac animal themes with unique challenges.
• 📊 Progress Tracking: Save your progress and track your achievements across all levels.

📱 Screenshots

🧳 Requirements

• iOS Version: iOS 17.0 or later
• Compatible Devices: iPhone, iPad
• Xcode: 15.0 or later
• Swift: 5.0+

💻 Installation

iOS App Store

The game is available for download on the App Store. Click the link below to download:

Local Development

1. Clone the repository:

   git clone https://github.com/banghuazhao/Spring-Festival-Crush.git
   cd Spring-Festival-Crush

2. Open the project:

   • Open SpringFestivalCrush.xcodeproj in Xcode
   • Select your target device or simulator

3. Build and run:

   • Press Cmd + R to build and run the project
   • Or click the "Play" button in Xcode

🎯 How to Play

1. Match 3 or More: Swipe to match three or more identical elements in a row to clear them from the board.
2. Complete Objectives: Meet the goals for each level within the allotted moves or time limit.
3. Progress Through Levels: Advance through increasingly difficult levels and unlock new challenges as you go.
4. Unlock Zodiac Themes: Complete levels to unlock different Chinese zodiac animal themes.

🏗️ Project Structure

SpringFestivalCrush/
├── Model/                 # Data models and game logic
│   ├── Game/             # Core game mechanics
│   ├── Level/            # Level data and objectives
│   ├── Music/            # Audio management
│   ├── Record/           # Progress tracking
│   └── Settings/         # App settings and themes
├── Scene/                # SpriteKit game scenes
├── View/                 # SwiftUI views and UI components
├── Assets.xcassets/      # Images and app icons
├── Sounds/               # Audio files
├── Levels/               # Level configuration files
└── Util/                 # Utility classes and extensions

🛠️ Development

Tech Stack

• Language: Swift 5.0+
• Game Framework: SpriteKit
• UI Framework: SwiftUI
• Concurrency: Swift Concurrency (async/await)
• Data Persistence: SwiftData
• Ad Integration: Google AdMob
• Build System: Xcode

Key Features

• Modern Swift: Leverages the latest Swift features including async/await and SwiftData
• Performance Optimized: Efficient memory management and smooth 60fps gameplay
• Accessibility: Supports VoiceOver and other accessibility features
• Localization: Available in English, Simplified Chinese, and Traditional Chinese

📋 Release Notes

Version 2.0 (Latest)

• ✨ Enhanced graphics and animations
• 🎵 Improved audio experience with traditional Chinese music
• 🌟 Added new zodiac themes and levels
• 📊 Better progress tracking and achievements
• 🐛 Bug fixes and performance improvements

Version 1.0

• 🎮 Initial release with core match-3 gameplay
• 🎨 Spring Festival themed graphics and elements
• 📱 Support for iPhone and iPad

🤝 Contributing

We welcome contributions to the project! Here's how you can help:

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

Development Guidelines

• Follow Swift style guidelines
• Add comments for complex logic
• Test on both iPhone and iPad
• Ensure accessibility compliance

🐛 Issues & Support

If you encounter any bugs or have suggestions:

• GitHub Issues: Open an issue
• App Store Reviews: Leave a review on the App Store
• Email Support: Contact us through the app settings

📞 Contact

Get in touch with us:

• GitHub: @banghuazhao
• App Store: Spring Festival Crush - Match 3
• Email: Contact through the app settings
• Website: GitHub Repository

For business inquiries or collaboration opportunities, please reach out through GitHub or the app.

📄 License

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

🙏 Acknowledgments

• Traditional Chinese music and sound effects
• Spring Festival cultural elements and themes
• The SpriteKit and SwiftUI communities
• All beta testers and contributors

---

© 2019 - 2025 Spring Festival Crush - Match 3 by Appsbay. All rights reserved.