zentap/README.md

ZenTap - Mindful Bubble Popping Game

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 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
• Google Play Games Integration
• Theme System
• Collision & Tilt Features
• Localization

---

Made with ❤️ for mindfulness and stress relief