Startseite Erkunden Hilfe
Anmelden
fsociety
/
zentap
2
0
Fork 0
Dateien Issues 0 Pull-Requests 0 Wiki

Keine Beschreibung

Struktur: 844319f885
Branches Tags
zentap
ZIP TAR.GZ
Fszontagh 844319f885 feat: Implement theme-aware UI with instant theme switching vor 10 Monaten
.roo f0b9f8e2a3 feat: Add donation button support (v1.0.2) vor 10 Monaten
android 8624a986eb feat: implement Google Play Games Services integration vor 10 Monaten
assets 27098f62d0 logos to google vor 10 Monaten
docs 11467b1759 feat: Implement theme-aware UI with instant theme switching vor 10 Monaten
ios e7b2a18e6f Update app icons across all platforms from logo_1024x1024.png vor 10 Monaten
lib 11467b1759 feat: Implement theme-aware UI with instant theme switching vor 10 Monaten
linux f0b9f8e2a3 feat: Add donation button support (v1.0.2) vor 10 Monaten
macos f0b9f8e2a3 feat: Add donation button support (v1.0.2) vor 10 Monaten
scripts dc9574589e Performance optimizations and audio quality improvements vor 10 Monaten
test 095721fd73 Fix bubble shake and collision issues vor 10 Monaten
web e7b2a18e6f Update app icons across all platforms from logo_1024x1024.png vor 10 Monaten
windows f0b9f8e2a3 feat: Add donation button support (v1.0.2) vor 10 Monaten
.gitignore efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure vor 10 Monaten
.metadata efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure vor 10 Monaten
README.md 11467b1759 feat: Implement theme-aware UI with instant theme switching vor 10 Monaten
analysis_options.yaml efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure vor 10 Monaten
devtools_options.yaml dc9574589e Performance optimizations and audio quality improvements vor 10 Monaten
l10n.yaml 1e08336ade feat: Complete internationalization implementation vor 10 Monaten
logo_orig.png e7b2a18e6f Update app icons across all platforms from logo_1024x1024.png vor 10 Monaten
pubspec.lock 1e08336ade feat: Complete internationalization implementation vor 10 Monaten
pubspec.yaml 11467b1759 feat: Implement theme-aware UI with instant theme switching vor 10 Monaten

README.md

ZenTap - Mindful Bubble Popping Game

ZenTap Logo

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:

Made with ❤️ for mindfulness and stress relief