Accueil Explorer Aide
Connexion
fsociety
/
zentap
2
0
Fork 0
Fichiers Tickets 0 Pull Requests 0 Wiki

Aucune description

Branche: main
Branches Tags
zentap
ZIP TAR.GZ
Fszontagh be71665529 update changelog rules il y a 2 mois
.roo f0b9f8e2a3 feat: Add donation button support (v1.0.2) il y a 5 mois
android 0d3959540d more improvements il y a 4 mois
assets fc8f3a0474 Implement seasonal themes and audio system enhancements il y a 4 mois
docs 2e6cfa8359 Complete localization implementation il y a 4 mois
ios 0d3959540d more improvements il y a 4 mois
lib b17451d6b6 Version 1.0.5: Update changelog format and fix SDK compatibility il y a 2 mois
linux 0d3959540d more improvements il y a 4 mois
macos 0d3959540d more improvements il y a 4 mois
scripts b17451d6b6 Version 1.0.5: Update changelog format and fix SDK compatibility il y a 2 mois
test 095721fd73 Fix bubble shake and collision issues il y a 5 mois
web e7b2a18e6f Update app icons across all platforms from logo_1024x1024.png il y a 5 mois
windows 0d3959540d more improvements il y a 4 mois
.gitignore efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure il y a 5 mois
.metadata efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure il y a 5 mois
CHANGELOG.md be71665529 update changelog rules il y a 2 mois
README.md 11467b1759 feat: Implement theme-aware UI with instant theme switching il y a 5 mois
RELEASE_BUILD_SUMMARY.md e8500e98f9 feat: Add production release build configuration il y a 5 mois
analysis_options.yaml efd08170b7 Phase 1: Project initialization - Flutter project with Flame, dependencies, and folder structure il y a 5 mois
devtools_options.yaml dc9574589e Performance optimizations and audio quality improvements il y a 5 mois
l10n.yaml 1e08336ade feat: Complete internationalization implementation il y a 5 mois
logo_orig.png e7b2a18e6f Update app icons across all platforms from logo_1024x1024.png il y a 5 mois
pubspec.lock b17451d6b6 Version 1.0.5: Update changelog format and fix SDK compatibility il y a 2 mois
pubspec.yaml b17451d6b6 Version 1.0.5: Update changelog format and fix SDK compatibility il y a 2 mois

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