How rohansingh3593/bubble-time-progress-app-flutter- works
Momentum is a Flutter time-progress and task-management app, with a FastAPI/MongoDB starter backend for live task sync. The main user flow is viewing year, month, week, or day bubbles, opening date-specific tasks, and tracking completion; the README explicitly documents the bubble-to-task navigation and sync flow. Other screens in the tree indicate journaling, goals, motivation, productivity, rewards, and timeline features, but their detailed behavior was not sampled. Edges are limited to README statements and backend source excerpts; unsampled Dart internals are not assumed.
Main entry points: main.dart Flutter App · bubble_widget.dart Bubble UI · main.py FastAPI Backend · sync_service.dart Sync Client
Components 27
Time Progress
- Flutter App
lib/main.dart - Year View
lib/screens/year_view.dart - Month View
lib/screens/month_view.dart - Week View
lib/screens/week_view.dart - Day View
lib/screens/day_view.dart - Bubble UI
lib/widgets/bubble_widget.dart
Tasks and Records
- Task Screen
lib/screens/task_screen.dart - Task Model
lib/models/task_model.dart - Local Storage
lib/services/hive_service.dart - Journal
lib/screens/journal_view.dart - Journey Timeline
lib/screens/journey_timeline_view.dart
Personal Insights
- Goal Dashboard
lib/screens/goal_dashboard_view.dart - Productivity Timeline
lib/screens/productivity_timeline_view.dart - Motivation Dashboard
lib/screens/motivation_motto_dashboard_view.dart - Reward History
lib/screens/reward_money_history_view.dart
Live Sync
- Sync Client
lib/services/sync_service.dart - FastAPI Backend
backend/main.py - Sync Payloads
backend/models.py - WebSocket Manager
backend/websocket_manager.py - Task Collection
backend/database.py
App Hosts
- Windows Host
windows/runner/flutter_window.cpp - Linux Host
linux/runner/my_application.cc - Android Host
android/app/src/main/kotlin/com/example/momentum/MainActivity.kt - iOS Host
ios/Runner/AppDelegate.swift
Other components
- App User
- MongoDB
- WebSocket Clients
Connections 24
- App User → Flutter App: uses
README.md - Flutter App → Year View: shows time
- Flutter App → Month View: shows time
- Flutter App → Week View: shows time
- Flutter App → Day View: shows time
- Year View → Bubble UI: renders
- Month View → Bubble UI: renders
- Week View → Bubble UI: renders
- Day View → Bubble UI: renders
- Bubble UI → Task Screen: opens on tap
README.md - Task Screen → Task Model: manages
- Task Model → Local Storage: stored by
README.md - App User → Sync Client: syncs tasks
README.md - Sync Client → FastAPI Backend: sends events
README.md - FastAPI Backend → Task Collection: reads and writes
backend/main.py - FastAPI Backend → Sync Payloads: validates payloads
backend/main.py - FastAPI Backend → WebSocket Manager: broadcasts events
backend/main.py - Task Collection → MongoDB: stores tasks
- WebSocket Manager → WebSocket Clients: broadcasts to
backend/websocket_manager.py - WebSocket Clients → Sync Client: delivers updates
README.md - Flutter App → Windows Host: hosted by
- Flutter App → Linux Host: hosted by
- Flutter App → Android Host: hosted by
- Flutter App → iOS Host: hosted by