# ZenTap - Mindful Bubble Popping Game

![ZenTap Logo](assets/icon/icon.png)

A stress-relief mobile game built with Flutter that combines mindful bubble popping with seasonal themes and relaxing gameplay.

## 🧘‍♀️ Features

- **Mindful Gameplay**: Pop bubbles to relieve stress and practice mindfulness
- **Zen Mode**: Timer-free mode for pure relaxation
- **Seasonal Themes**: 5 beautiful themes (Default, Spring, Summer, Autumn, Winter)
- **Shake to Spawn**: Physical device shake creates new bubbles
- **Multi-language**: English, Hungarian, German, French, Spanish, Italian support
- **Google Play Games**: Achievements and leaderboards
- **Audio Control**: Background music and sound effects with volume control
- **Statistics**: Track your relaxation journey with detailed stats and charts

## 🎮 Game Modes

### Play Mode
- 60-second gameplay sessions
- Score-based progression
- Track daily and total relaxation points

### Zen Mode
- No time limits
- Pure stress relief experience
- Focus on mindfulness and breathing

## 🎨 Themes

- **Default (fSociety)**: Dark theme with cyan accents
- **Spring Bloom**: Fresh greens and pastels
- **Summer Bright**: Blues and yellows
- **Autumn Leaves**: Warm oranges and browns
- **Winter Frost**: Cool blues and whites

## 🛠️ Built With

- **Flutter**: Cross-platform mobile development
- **Flame**: 2D game engine for Flutter
- **SharedPreferences**: Local data persistence
- **FL Chart**: Beautiful charts for statistics
- **Google Play Games Services**: Social gaming features

## 📱 Installation

### From Source
1. Clone the repository
2. Install Flutter dependencies: `flutter pub get`
3. Run the app: `flutter run`

### Play Store
Coming soon!

## 🏗️ Architecture

The app follows clean architecture principles with:
- **Game Engine**: Flame-based bubble physics and animations
- **Theme System**: Dynamic seasonal theming with instant updates
- **State Management**: StatefulWidget with proper lifecycle management
- **Localization**: Full i18n support with arb files
- **Data Persistence**: Local storage for settings and statistics

## 📊 Statistics & Progress

Track your mindfulness journey with:
- Daily relaxation points
- Total bubbles popped
- Current streak tracking
- Weekly and monthly progress charts
- Achievement system

## 🤝 Contributing

Contributions are welcome! Please read our contributing guidelines in `docs/` folder.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- Flutter team for the amazing framework
- Flame engine developers
- All contributors and testers

## 📚 Documentation

Detailed documentation is available in the `docs/` folder:
- [Implementation Summary](docs/IMPLEMENTATION_SUMMARY.md)
- [Google Play Games Integration](docs/GOOGLE_PLAY_GAMES.md)
- [Theme System](docs/THEME_AWARE_UI_IMPLEMENTATION.md)
- [Collision & Tilt Features](docs/COLLISION_AND_TILT_FEATURES.md)
- [Localization](docs/LOCALIZATION_FIXES.md)

---

**Made with ❤️ for mindfulness and stress relief**