# azuos01/life-balance-tracker architecture

> Architecture diagram of the GitHub repository azuos01/life-balance-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azuos01/life-balance-tracker
- Repository: https://github.com/azuos01/life-balance-tracker

## Overview

Life Balance Tracker is a Flutter app for tracking personal-life balance through goals, activities, tasks, check-ins, and learning, with gamification and optional integrations. The documented user workflow is to sign in or use local mode, manage life-planning data, and review progress on the dashboard; tasks can also be generated from Gmail or synchronized from Google Calendar. README documentation supports the capabilities and integrations shown here, but no source excerpts were supplied, so internal call ownership and provider-to-service wiring cannot be verified.

Main entry points: [`lib/screens/tasks/tasks_screen.dart`](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/tasks/tasks_screen.dart) (Task planning), [`lib/screens/dashboard_screen.dart`](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/dashboard_screen.dart) (Dashboard), [`lib/providers/gmail_tasks_provider.dart`](https://github.com/azuos01/life-balance-tracker/blob/main/lib/providers/gmail_tasks_provider.dart) (Email task analysis), [`lib/services/auth_service.dart`](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/auth_service.dart) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_app_shell["App navigation<br/>[main_screen.dart]"]
  node_dashboard["Dashboard"]
  node_quotes["Daily quotes"]
end

subgraph group_planning["Task planning"]
  node_tasks["Task planning<br/>[tasks_screen.dart]"]
  node_task_reports["Task reports"]
  node_ai_tasks["AI task suggestions"]
  node_email_tasks["Email task analysis"]
end

subgraph group_tracking["Life tracking"]
  node_activities["Activities"]
  node_checkins["Daily check-ins"]
  node_goals["Life goals<br/>[goals_screen.dart]"]
  node_learning["Learning tracker"]
  node_gamification["XP and achievements"]
end

subgraph group_integrations["External integrations"]
  node_calendar["Calendar"]
  node_calendar_sync["Calendar sync"]
  node_weather["Weather forecast"]
  node_openai["OpenAI service"]
  node_gmail["Gmail API"]
  node_google_calendar["Google Calendar API"]
end

subgraph group_data["Data and identity"]
  node_auth["Authentication<br/>[auth_service.dart]"]
  node_local_data[("Local storage")]
  node_cloud_data[("Cloud data")]
end

node_user(("User"))

node_user -->|"uses"| node_app_shell
node_app_shell -->|"supports login"| node_auth
node_auth -->|"uses offline mode"| node_local_data
node_auth -->|"migrates on login"| node_cloud_data
node_user -->|"plans tasks"| node_tasks
node_tasks -->|"requests suggestions"| node_ai_tasks
node_ai_tasks -->|"uses"| node_openai
node_tasks -->|"analyzes email"| node_email_tasks
node_email_tasks -->|"reads email"| node_gmail
node_email_tasks -->|"analyzes snippets"| node_openai
node_user -->|"manages events"| node_calendar
node_calendar_sync -->|"syncs events"| node_google_calendar
node_calendar_sync -->|"creates planned tasks"| node_tasks
node_user -->|"logs activity"| node_activities
node_user -->|"records check-ins"| node_checkins
node_user -->|"tracks goals"| node_goals
node_user -->|"updates learning"| node_learning
node_user -->|"reviews progress"| node_dashboard
node_dashboard -->|"shows forecast"| node_weather
node_dashboard -->|"shows daily quote"| node_quotes
node_tasks -->|"reports metrics"| node_task_reports
node_tasks -->|"syncs tasks"| node_cloud_data
node_activities -->|"stores activities"| node_cloud_data
node_gamification -->|"contributes progress"| node_dashboard

click node_app_shell "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/main_screen.dart"
click node_dashboard "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/dashboard_screen.dart"
click node_auth "https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/auth_service.dart"
click node_tasks "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/tasks/tasks_screen.dart"
click node_task_reports "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/reports/reports_screen.dart"
click node_ai_tasks "https://github.com/azuos01/life-balance-tracker/blob/main/lib/providers/ai_agent_provider.dart"
click node_email_tasks "https://github.com/azuos01/life-balance-tracker/blob/main/lib/providers/gmail_tasks_provider.dart"
click node_calendar "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/calendar/calendar_screen.dart"
click node_calendar_sync "https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/calendar_service.dart"
click node_activities "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/activities_screen.dart"
click node_checkins "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/logging/morning_checkin_screen.dart"
click node_goals "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/goals_screen.dart"
click node_learning "https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/learning/learning_tracker_screen.dart"
click node_gamification "https://github.com/azuos01/life-balance-tracker/blob/main/lib/models/achievement_model.dart"
click node_weather "https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/weather_service.dart"
click node_quotes "https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/quotes_service.dart"
click node_openai "https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/openai_service.dart"
click node_local_data "https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/storage_service.dart"
click node_cloud_data "https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/firestore_service.dart"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_shell,node_dashboard,node_quotes,node_user toneBlue
class node_tasks,node_task_reports,node_ai_tasks,node_email_tasks toneAmber
class node_activities,node_checkins,node_goals,node_learning,node_gamification toneMint
class node_calendar,node_calendar_sync,node_weather,node_openai,node_gmail,node_google_calendar toneRose
class node_auth,node_local_data,node_cloud_data toneIndigo
```

## Components

### App experience

- [App navigation](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/main_screen.dart): `lib/screens/main_screen.dart`
- [Dashboard](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/dashboard_screen.dart): `lib/screens/dashboard_screen.dart`
- [Daily quotes](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/quotes_service.dart): `lib/services/quotes_service.dart`

### Task planning

- [Task planning](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/tasks/tasks_screen.dart): `lib/screens/tasks/tasks_screen.dart`
- [Task reports](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/reports/reports_screen.dart): `lib/screens/reports/reports_screen.dart`
- [AI task suggestions](https://github.com/azuos01/life-balance-tracker/blob/main/lib/providers/ai_agent_provider.dart): `lib/providers/ai_agent_provider.dart`
- [Email task analysis](https://github.com/azuos01/life-balance-tracker/blob/main/lib/providers/gmail_tasks_provider.dart): `lib/providers/gmail_tasks_provider.dart`

### Life tracking

- [Activities](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/activities_screen.dart): `lib/screens/activities_screen.dart`
- [Daily check-ins](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/logging/morning_checkin_screen.dart): `lib/screens/logging/morning_checkin_screen.dart`
- [Life goals](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/goals_screen.dart): `lib/screens/goals_screen.dart`
- [Learning tracker](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/learning/learning_tracker_screen.dart): `lib/screens/learning/learning_tracker_screen.dart`
- [XP and achievements](https://github.com/azuos01/life-balance-tracker/blob/main/lib/models/achievement_model.dart): `lib/models/achievement_model.dart`

### External integrations

- [Calendar](https://github.com/azuos01/life-balance-tracker/blob/main/lib/screens/calendar/calendar_screen.dart): `lib/screens/calendar/calendar_screen.dart`
- [Calendar sync](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/calendar_service.dart): `lib/services/calendar_service.dart`
- [Weather forecast](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/weather_service.dart): `lib/services/weather_service.dart`
- [OpenAI service](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/openai_service.dart): `lib/services/openai_service.dart`
- **Gmail API**
- **Google Calendar API**

### Data and identity

- [Authentication](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [Local storage](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/storage_service.dart): `lib/services/storage_service.dart`
- [Cloud data](https://github.com/azuos01/life-balance-tracker/blob/main/lib/services/firestore_service.dart): `lib/services/firestore_service.dart`

### Other components

- **User**

## Connections

- User → App navigation: uses (evidence: `README.md`)
- App navigation → Authentication: supports login (evidence: `README.md`)
- Authentication → Local storage: uses offline mode (evidence: `README.md`)
- Authentication → Cloud data: migrates on login (evidence: `README.md`)
- User → Task planning: plans tasks (evidence: `README.md`)
- Task planning → AI task suggestions: requests suggestions (evidence: `README.md`)
- AI task suggestions → OpenAI service: uses (evidence: `README.md`)
- Task planning → Email task analysis: analyzes email (evidence: `README.md`)
- Email task analysis → Gmail API: reads email (evidence: `README.md`)
- Email task analysis → OpenAI service: analyzes snippets (evidence: `README.md`)
- User → Calendar: manages events (evidence: `README.md`)
- Calendar sync → Google Calendar API: syncs events (evidence: `README.md`)
- Calendar sync → Task planning: creates planned tasks (evidence: `README.md`)
- User → Activities: logs activity (evidence: `README.md`)
- User → Daily check-ins: records check-ins (evidence: `README.md`)
- User → Life goals: tracks goals (evidence: `README.md`)
- User → Learning tracker: updates learning (evidence: `README.md`)
- User → Dashboard: reviews progress (evidence: `README.md`)
- Dashboard → Weather forecast: shows forecast (evidence: `README.md`)
- Dashboard → Daily quotes: shows daily quote (evidence: `README.md`)
- Task planning → Task reports: reports metrics (evidence: `README.md`)
- Task planning → Cloud data: syncs tasks (evidence: `README.md`)
- Activities → Cloud data: stores activities (evidence: `README.md`)
- XP and achievements → Dashboard: contributes progress (evidence: `README.md`)
