# kss-official/livo-kss architecture

> Architecture diagram of the GitHub repository kss-official/livo-kss, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kss-official/livo-kss
- Repository: https://github.com/kss-official/livo-kss

## Overview

LIVO is presented as a personal life-management app spanning tasks, goals, habits, planning, finances, AI assistance, and analytics. The visible mobile workflow starts at the tab navigator and presents Home, Planning, AI chat, and Insights; the API client is configured for a Spring backend. Backend domain modules and database migrations indicate broader capabilities, but their implementation files are placeholders or were not sampled, so their internal call wiring is omitted. Several displayed screens currently use hard-coded or mock data.

Main entry points: [`frontend/src/navigation/RootNavigator.tsx`](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/navigation/RootNavigator.tsx) (Tab navigator), [`frontend/App.tsx`](https://github.com/kss-official/livo-kss/blob/Akash/frontend/App.tsx) (App bootstrap), [`frontend/src/screens/HomeScreen.tsx`](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/HomeScreen.tsx) (Home dashboard), [`frontend/src/services/api.ts`](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/services/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_app["App bootstrap<br/>[App.tsx]"]
  node_navigator["Tab navigator<br/>[RootNavigator.tsx]"]
  node_home["Home dashboard<br/>[HomeScreen.tsx]"]
  node_planning_screen["Planning view<br/>[PlanningScreen.tsx]"]
  node_ai_screen["AI chat view<br/>[AiScreen.tsx]"]
  node_insights_screen["Insights view<br/>[InsightsScreen.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_domain_types["Domain types<br/>[index.ts]"]
end

subgraph group_planning["Planning domains"]
  node_task_domain["Task management"]
  node_plan_domain["Schedule planning"]
  node_conflict_engine["Conflict engine"]
  node_overload_engine["Overload engine"]
  node_goal_domain["Goal tracking"]
  node_habit_domain["Habit tracking"]
  node_finance_domain["Finance tracking"]
end

subgraph group_intelligence["Intelligence"]
  node_ai_domain["AI assistance"]
  node_pattern_engine["Pattern engine"]
  node_priority_engine["Priority engine"]
end

subgraph group_platform["Backend platform"]
  node_backend_app["Spring application"]
  node_auth["Authentication"]
  node_user_domain["User profile"]
  node_sync_domain["Data sync"]
  node_database[("Application database")]
end

node_user(("App user"))

node_user -->|"opens"| node_app
node_app -->|"renders"| node_navigator
node_navigator -->|"routes"| node_home
node_navigator -->|"routes"| node_planning_screen
node_navigator -->|"routes"| node_ai_screen
node_navigator -->|"routes"| node_insights_screen
node_home -->|"reads mock data"| node_api_client
node_api_client -->|"targets API"| node_backend_app
node_backend_app -->|"schema migrations"| node_database

click node_app "https://github.com/kss-official/livo-kss/blob/Akash/frontend/App.tsx"
click node_navigator "https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/navigation/RootNavigator.tsx"
click node_home "https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/HomeScreen.tsx"
click node_planning_screen "https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/PlanningScreen.tsx"
click node_ai_screen "https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/AiScreen.tsx"
click node_insights_screen "https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/InsightsScreen.tsx"
click node_api_client "https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/services/api.ts"
click node_domain_types "https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/types/index.ts"
click node_backend_app "https://github.com/kss-official/livo-kss/blob/Akash/Backend/src/main/java/com/livo/api/LivoApplication.java"
click node_auth "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/auth"
click node_user_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/user"
click node_task_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/task"
click node_plan_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/plan"
click node_conflict_engine "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/conflict"
click node_overload_engine "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/overload"
click node_goal_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/goal"
click node_habit_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/habit"
click node_finance_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/finance"
click node_ai_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/ai"
click node_pattern_engine "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/pattern"
click node_priority_engine "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/priority"
click node_sync_domain "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/sync"
click node_database "https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/resources/db/migration"

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,node_navigator,node_home,node_planning_screen,node_ai_screen,node_insights_screen,node_api_client,node_domain_types,node_user toneBlue
class node_task_domain,node_plan_domain,node_conflict_engine,node_overload_engine,node_goal_domain,node_habit_domain,node_finance_domain toneAmber
class node_ai_domain,node_pattern_engine,node_priority_engine toneMint
class node_backend_app,node_auth,node_user_domain,node_sync_domain,node_database toneRose
```

## Components

### Mobile app

- [App bootstrap](https://github.com/kss-official/livo-kss/blob/Akash/frontend/App.tsx): `frontend/App.tsx`
- [Tab navigator](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/navigation/RootNavigator.tsx): `frontend/src/navigation/RootNavigator.tsx`
- [Home dashboard](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/HomeScreen.tsx): `frontend/src/screens/HomeScreen.tsx`
- [Planning view](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/PlanningScreen.tsx): `frontend/src/screens/PlanningScreen.tsx`
- [AI chat view](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/AiScreen.tsx): `frontend/src/screens/AiScreen.tsx`
- [Insights view](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/screens/InsightsScreen.tsx): `frontend/src/screens/InsightsScreen.tsx`
- [API client](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Domain types](https://github.com/kss-official/livo-kss/blob/Akash/frontend/src/types/index.ts): `frontend/src/types/index.ts`

### Planning domains

- [Task management](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/task): `Backend/src/main/java/com/livo/api/modules/task`
- [Schedule planning](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/plan): `Backend/src/main/java/com/livo/api/modules/plan`
- [Conflict engine](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/conflict): `Backend/src/main/java/com/livo/api/engines/conflict`
- [Overload engine](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/overload): `Backend/src/main/java/com/livo/api/engines/overload`
- [Goal tracking](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/goal): `Backend/src/main/java/com/livo/api/modules/goal`
- [Habit tracking](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/habit): `Backend/src/main/java/com/livo/api/modules/habit`
- [Finance tracking](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/finance): `Backend/src/main/java/com/livo/api/modules/finance`

### Intelligence

- [AI assistance](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/ai): `Backend/src/main/java/com/livo/api/modules/ai`
- [Pattern engine](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/pattern): `Backend/src/main/java/com/livo/api/engines/pattern`
- [Priority engine](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/engines/priority): `Backend/src/main/java/com/livo/api/engines/priority`

### Backend platform

- [Spring application](https://github.com/kss-official/livo-kss/blob/Akash/Backend/src/main/java/com/livo/api/LivoApplication.java): `Backend/src/main/java/com/livo/api/LivoApplication.java`
- [Authentication](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/auth): `Backend/src/main/java/com/livo/api/modules/auth`
- [User profile](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/user): `Backend/src/main/java/com/livo/api/modules/user`
- [Data sync](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/java/com/livo/api/modules/sync): `Backend/src/main/java/com/livo/api/modules/sync`
- [Application database](https://github.com/kss-official/livo-kss/tree/Akash/Backend/src/main/resources/db/migration): `Backend/src/main/resources/db/migration`

### Other components

- **App user**

## Connections

- App user → App bootstrap: opens
- App bootstrap → Tab navigator: renders
- Tab navigator → Home dashboard: routes
- Tab navigator → Planning view: routes
- Tab navigator → AI chat view: routes
- Tab navigator → Insights view: routes
- Home dashboard → API client: reads mock data
- API client → Spring application: targets API
- Spring application → Application database: schema migrations