Skip to content

byteWizard-zero/flow-state-habit-rpg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌊 FlowState | Gamified Habit Cultivation Engine

Flutter Dart Hive Status

"Transform routine into a quest. Rise through the ranks of self-improvement by gamifying habits, battling bosses, and synchronizing with real-time solar phases."

FlowState is a high-fidelity, premium mobile application built with Flutter and Dart, designed to transform daily habit tracking into an immersive RPG adventure. Featuring a dynamic sky-phase rendering engine, local binary caching, layout constraints, and a customized boss fight tracker, this app gamifies daily task execution to optimize consistency.


✨ Features

  • 🎬 Branded Splash Sequence: Optimized native launch mask for clean background SQLite/Hive initialization without frame drops.
  • ☀️🌕 Contextual Sky-Phase Engine: Immersive, dynamic linear ambient gradients and layered Gaussian blur auroras that programmatically map to real-world solar cycles.
  • 💾 Dual-Box Hive Persistence: Lightweight, thread-safe NoSQL partition caching managing separate boxes for daily habit progress profiles and player status indicators.
  • ⚔️ Raid Boss Subsystem ("The Glitch Lord"): A real-time conditional health matrix tracking user task completion values to deal damage and award levels/experience.
  • 📊 Matrix Profile Metrics: Glassmorphic modal overlays presenting weekly consistency grids via modular vector rows.

🛠️ Tech Stack & Architecture

  • Framework: Flutter (Dart UI Lifecycle & Constraint Engine)
  • Database Architecture: Hive & Hive Flutter (Local Key-Value persistence on disk)
  • Animation & State: Custom implicit animation controllers, layout constraint builders, and haptic feedback service bridges.

🚀 Installation & Setup

For End Users (Quick APK Install)

  1. Go to the Releases section of this repository or download directly:
  2. Open and install the APK on your Android device (ensure "Install from Unknown Sources" is allowed).

For Developers (Build from Source)

  1. Clone the Repository:
    git clone https://github.com/byteWizard-zero/flow-state-habit-rpg.git
    cd flow-state-habit-rpg
  2. Install Flutter Dependencies:
    flutter pub get
  3. Build and Run:
    flutter run

About

A gamified habit tracking mobile RPG built with Flutter and Dart, featuring Hive NoSQL caching, a dynamic sky-phase rendering engine, and real-time boss fights.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors