Home Verkennen Help
Inloggen
fsociety
/
zentap
2
0
Vork 0
Bestanden Issues 0 Pull-aanvragen 0 Wiki

Geen omschrijving

Boom: 974a43ba93
Aftakkingen Labels
zentap
ZIP TAR.GZ
Fszontagh 974a43ba93 Fix menu overflow and move settings to menu items 6 maanden geleden
.roo f0b9f8e2a3 feat: Add donation button support (v1.0.2) 9 maanden geleden
android 0d3959540d more improvements 8 maanden geleden
assets fc8f3a0474 Implement seasonal themes and audio system enhancements 8 maanden geleden
docs 2e6cfa8359 Complete localization implementation 8 maanden geleden
ios 0d3959540d more improvements 8 maanden geleden
lib 974a43ba93 Fix menu overflow and move settings to menu items 6 maanden geleden
linux 0d3959540d more improvements 8 maanden geleden
macos 0d3959540d more improvements 8 maanden geleden
scripts e96b8cbbac Add Android emulator launcher scripts with resolution selection 6 maanden geleden
test 095721fd73 Fix bubble shake and collision issues 9 maanden geleden
web e7b2a18e6f Update app icons across all platforms from logo_1024x1024.png 9 maanden geleden
windows 0d3959540d more improvements 8 maanden geleden
.gitignore efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure 9 maanden geleden
.metadata efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure 9 maanden geleden
README.md 11467b1759 feat: Implement theme-aware UI with instant theme switching 9 maanden geleden
RELEASE_BUILD_SUMMARY.md e8500e98f9 feat: Add production release build configuration 9 maanden geleden
analysis_options.yaml efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure 9 maanden geleden
devtools_options.yaml dc9574589e Performance optimizations and audio quality improvements 9 maanden geleden
l10n.yaml 1e08336ade feat: Complete internationalization implementation 9 maanden geleden
logo_orig.png e7b2a18e6f Update app icons across all platforms from logo_1024x1024.png 9 maanden geleden
pubspec.lock 1e08336ade feat: Complete internationalization implementation 9 maanden geleden
pubspec.yaml fc8f3a0474 Implement seasonal themes and audio system enhancements 8 maanden geleden

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