# dkrishna-59/xcloud-app architecture

> Architecture diagram of the GitHub repository dkrishna-59/xcloud-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dkrishna-59/xcloud-app
- Repository: https://github.com/dkrishna-59/xcloud-app

## Overview

XCloud is a cloud-drive product with shared Kotlin/Compose clients and a separate Next.js web client. The main user flow is sign-in, browse and manage files, upload or share them, and view storage usage; trash and profile/preferences are additional stages. Core repositories implement shared authentication, file, trash, and user operations, while the web client has its own file-management services. The README establishes the multiplatform targets; links among unsampled screens and services are omitted where the excerpts and index do not show the caller.

Main entry points: [`app/web-app/src/lib/firebase.ts`](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/firebase.ts) (Firebase setup), [`app/shared/src/commonMain/kotlin/com/cloud/x/App.kt`](https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/App.kt) (Shared app), [`app/web-app/src/lib/upload-manager.ts`](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/upload-manager.ts) (Web uploads), [`app/web-app/src/lib/file-manager.ts`](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/file-manager.ts) (Web file manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client applications"]
  node_android["Android entry<br/>[MainActivity.kt]"]
  node_webui["Web drive UI"]
  node_webauth["Web sign-in<br/>[page.tsx]"]
end

subgraph group_shared["Shared experience"]
  node_app["Shared app<br/>[App.kt]"]
  node_authui["Authentication UI<br/>[AuthScreen.kt]"]
  node_dashboard["Drive dashboard<br/>[DashboardScreen.kt]"]
  node_storageui["Storage view"]
  node_authvm["Auth state<br/>[AuthViewModel.kt]"]
  node_storagewidget["Usage widget"]
end

subgraph group_domain["Drive domain"]
  node_authrepo["Authentication<br/>[AuthRepository.kt]"]
  node_filerepo["File operations<br/>[FileRepository.kt]"]
  node_trashrepo["Trash operations<br/>[TrashRepository.kt]"]
  node_userrepo["User profiles<br/>[UserRepository.kt]"]
  node_upload["Upload workflow"]
  node_quota["Quota calculations"]
  node_filemodel["File metadata<br/>[FileEntry.kt]"]
  node_usermodel["User metadata<br/>[UserMetadata.kt]"]
end

subgraph group_web["Web services"]
  node_webfiles["Web file manager<br/>[file-manager.ts]"]
  node_webupload["Web uploads<br/>[upload-manager.ts]"]
  node_webactivity["Activity logging"]
  node_webtrash["Web trash<br/>[trash-manager.ts]"]
end

subgraph group_cloud["Cloud services"]
  node_webfirebase["Firebase setup<br/>[firebase.ts]"]
  node_supabase["Supabase setup<br/>[supabase.ts]"]
  node_firebase[("Firebase services")]
  node_supabasestore[("Supabase storage")]
end

node_android -->|"launches"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"creates"| node_authvm
node_app -->|"creates"| node_storageui
node_authui -->|"uses"| node_authvm
node_authvm -->|"calls"| node_authrepo
node_storageui -->|"observes"| node_userrepo
node_storageui -->|"calculates with"| node_quota
node_storagewidget -->|"calculates with"| node_quota
node_usermodel -->|"formats using"| node_quota
node_filerepo -->|"uses"| node_upload
node_filerepo -->|"reads and writes"| node_filemodel
node_filerepo -.->|"records activity"| node_trashrepo
node_webui -.->|"manages files"| node_webfiles
node_webauth -.->|"authenticates with"| node_webfirebase
node_webupload -->|"updates folders"| node_webfiles
node_webupload -->|"logs activity"| node_webactivity
node_webupload -->|"writes metadata"| node_webfirebase
node_webupload -->|"uploads bytes"| node_supabase
node_webfiles -->|"reads and writes"| node_webfirebase
node_webactivity -->|"uses"| node_webfirebase
node_webtrash -->|"uses"| node_webfirebase
node_webtrash -->|"logs activity"| node_webactivity
node_webtrash -->|"uses"| node_webfiles
node_webfirebase -->|"configures"| node_firebase
node_supabase -.->|"configures"| node_supabasestore

click node_android "https://github.com/dkrishna-59/xcloud-app/blob/main/app/androidApp/src/main/kotlin/com/cloud/x/MainActivity.kt"
click node_app "https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/App.kt"
click node_authui "https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/AuthScreen.kt"
click node_dashboard "https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/DashboardScreen.kt"
click node_storageui "https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt"
click node_authvm "https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/AuthViewModel.kt"
click node_storagewidget "https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/components/StorageBreakdownWidget.kt"
click node_authrepo "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/AuthRepository.kt"
click node_filerepo "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/FileRepository.kt"
click node_trashrepo "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/TrashRepository.kt"
click node_userrepo "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/UserRepository.kt"
click node_upload "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/util/FileUploadManager.kt"
click node_quota "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/util/StorageQuotaManager.kt"
click node_filemodel "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/model/FileEntry.kt"
click node_usermodel "https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/model/UserMetadata.kt"
click node_webui "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/components/dashboard/XCloudDashboard.tsx"
click node_webauth "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/app/auth/page.tsx"
click node_webfiles "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/file-manager.ts"
click node_webupload "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/upload-manager.ts"
click node_webactivity "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/activity-manager.ts"
click node_webtrash "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/trash-manager.ts"
click node_webfirebase "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/firebase.ts"
click node_supabase "https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/supabase.ts"

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_android,node_webui,node_webauth toneBlue
class node_app,node_authui,node_dashboard,node_storageui,node_authvm,node_storagewidget toneAmber
class node_authrepo,node_filerepo,node_trashrepo,node_userrepo,node_upload,node_quota,node_filemodel,node_usermodel toneMint
class node_webfiles,node_webupload,node_webactivity,node_webtrash toneRose
class node_webfirebase,node_supabase,node_firebase,node_supabasestore toneIndigo
```

## Components

### Client applications

- [Android entry](https://github.com/dkrishna-59/xcloud-app/blob/main/app/androidApp/src/main/kotlin/com/cloud/x/MainActivity.kt): `app/androidApp/src/main/kotlin/com/cloud/x/MainActivity.kt`
- [Web drive UI](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/components/dashboard/XCloudDashboard.tsx): `app/web-app/src/components/dashboard/XCloudDashboard.tsx`
- [Web sign-in](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/app/auth/page.tsx): `app/web-app/src/app/auth/page.tsx`

### Shared experience

- [Shared app](https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/App.kt): `app/shared/src/commonMain/kotlin/com/cloud/x/App.kt`
- [Authentication UI](https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/AuthScreen.kt): `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/AuthScreen.kt`
- [Drive dashboard](https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/DashboardScreen.kt): `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/DashboardScreen.kt`
- [Storage view](https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt): `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt`
- [Auth state](https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/AuthViewModel.kt): `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/AuthViewModel.kt`
- [Usage widget](https://github.com/dkrishna-59/xcloud-app/blob/main/app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/components/StorageBreakdownWidget.kt): `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/components/StorageBreakdownWidget.kt`

### Drive domain

- [Authentication](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/AuthRepository.kt): `core/src/commonMain/kotlin/com/cloud/x/repository/AuthRepository.kt`
- [File operations](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/FileRepository.kt): `core/src/commonMain/kotlin/com/cloud/x/repository/FileRepository.kt`
- [Trash operations](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/TrashRepository.kt): `core/src/commonMain/kotlin/com/cloud/x/repository/TrashRepository.kt`
- [User profiles](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/repository/UserRepository.kt): `core/src/commonMain/kotlin/com/cloud/x/repository/UserRepository.kt`
- [Upload workflow](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/util/FileUploadManager.kt): `core/src/commonMain/kotlin/com/cloud/x/util/FileUploadManager.kt`
- [Quota calculations](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/util/StorageQuotaManager.kt): `core/src/commonMain/kotlin/com/cloud/x/util/StorageQuotaManager.kt`
- [File metadata](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/model/FileEntry.kt): `core/src/commonMain/kotlin/com/cloud/x/model/FileEntry.kt`
- [User metadata](https://github.com/dkrishna-59/xcloud-app/blob/main/core/src/commonMain/kotlin/com/cloud/x/model/UserMetadata.kt): `core/src/commonMain/kotlin/com/cloud/x/model/UserMetadata.kt`

### Web services

- [Web file manager](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/file-manager.ts): `app/web-app/src/lib/file-manager.ts`
- [Web uploads](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/upload-manager.ts): `app/web-app/src/lib/upload-manager.ts`
- [Activity logging](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/activity-manager.ts): `app/web-app/src/lib/activity-manager.ts`
- [Web trash](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/trash-manager.ts): `app/web-app/src/lib/trash-manager.ts`

### Cloud services

- [Firebase setup](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/firebase.ts): `app/web-app/src/lib/firebase.ts`
- [Supabase setup](https://github.com/dkrishna-59/xcloud-app/blob/main/app/web-app/src/lib/supabase.ts): `app/web-app/src/lib/supabase.ts`
- **Firebase services**
- **Supabase storage**

## Connections

- Android entry → Shared app: launches (evidence: `app/androidApp/src/main/kotlin/com/cloud/x/MainActivity.kt`)
- Shared app → Authentication UI: routes to (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/App.kt`)
- Shared app → Drive dashboard: routes to (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/App.kt`)
- Shared app → Auth state: creates (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/App.kt`)
- Shared app → Storage view: creates (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/App.kt`)
- Authentication UI → Auth state: uses (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/AuthScreen.kt`)
- Auth state → Authentication: calls (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/AuthViewModel.kt`)
- Storage view → User profiles: observes (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt`)
- Storage view → Quota calculations: calculates with (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt`)
- Usage widget → Quota calculations: calculates with (evidence: `app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/components/StorageBreakdownWidget.kt`)
- User metadata → Quota calculations: formats using (evidence: `core/src/commonMain/kotlin/com/cloud/x/model/UserMetadata.kt`)
- File operations → Upload workflow: uses (evidence: `core/src/commonMain/kotlin/com/cloud/x/repository/FileRepository.kt`)
- File operations → File metadata: reads and writes (evidence: `core/src/commonMain/kotlin/com/cloud/x/repository/FileRepository.kt`)
- File operations → Trash operations: records activity
- Web drive UI → Web file manager: manages files
- Web sign-in → Firebase setup: authenticates with
- Web uploads → Web file manager: updates folders (evidence: `app/web-app/src/lib/upload-manager.ts`)
- Web uploads → Activity logging: logs activity (evidence: `app/web-app/src/lib/upload-manager.ts`)
- Web uploads → Firebase setup: writes metadata (evidence: `app/web-app/src/lib/upload-manager.ts`)
- Web uploads → Supabase setup: uploads bytes (evidence: `app/web-app/src/lib/upload-manager.ts`)
- Web file manager → Firebase setup: reads and writes (evidence: `app/web-app/src/lib/file-manager.ts`)
- Activity logging → Firebase setup: uses (evidence: `app/web-app/src/lib/activity-manager.ts`)
- Web trash → Firebase setup: uses (evidence: `app/web-app/src/lib/trash-manager.ts`)
- Web trash → Activity logging: logs activity (evidence: `app/web-app/src/lib/trash-manager.ts`)
- Web trash → Web file manager: uses (evidence: `app/web-app/src/lib/trash-manager.ts`)
- Firebase setup → Firebase services: configures (evidence: `app/web-app/src/lib/firebase.ts`)
- Supabase setup → Supabase storage: configures
