How dkrishna-59/xcloud-app works
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: firebase.ts Firebase setup · App.kt Shared app · upload-manager.ts Web uploads · file-manager.ts Web file manager
Components 25
Client applications
- Android entry
app/androidApp/src/main/kotlin/com/cloud/x/MainActivity.kt - Web drive UI
app/web-app/src/components/dashboard/XCloudDashboard.tsx - Web sign-in
app/web-app/src/app/auth/page.tsx
Shared experience
- Shared app
app/shared/src/commonMain/kotlin/com/cloud/x/App.kt - Authentication UI
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/AuthScreen.kt - Drive dashboard
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/DashboardScreen.kt - Storage view
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt - Auth state
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/AuthViewModel.kt - Usage widget
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/components/StorageBreakdownWidget.kt
Drive domain
- Authentication
core/src/commonMain/kotlin/com/cloud/x/repository/AuthRepository.kt - File operations
core/src/commonMain/kotlin/com/cloud/x/repository/FileRepository.kt - Trash operations
core/src/commonMain/kotlin/com/cloud/x/repository/TrashRepository.kt - User profiles
core/src/commonMain/kotlin/com/cloud/x/repository/UserRepository.kt - Upload workflow
core/src/commonMain/kotlin/com/cloud/x/util/FileUploadManager.kt - Quota calculations
core/src/commonMain/kotlin/com/cloud/x/util/StorageQuotaManager.kt - File metadata
core/src/commonMain/kotlin/com/cloud/x/model/FileEntry.kt - User metadata
core/src/commonMain/kotlin/com/cloud/x/model/UserMetadata.kt
Web services
- Web file manager
app/web-app/src/lib/file-manager.ts - Web uploads
app/web-app/src/lib/upload-manager.ts - Activity logging
app/web-app/src/lib/activity-manager.ts - Web trash
app/web-app/src/lib/trash-manager.ts
Cloud services
- Firebase setup
app/web-app/src/lib/firebase.ts - Supabase setup
app/web-app/src/lib/supabase.ts - Firebase services
- Supabase storage
Connections 27
- Android entry → Shared app: launches
app/androidApp/src/main/kotlin/com/cloud/x/MainActivity.kt - Shared app → Authentication UI: routes to
app/shared/src/commonMain/kotlin/com/cloud/x/App.kt - Shared app → Drive dashboard: routes to
app/shared/src/commonMain/kotlin/com/cloud/x/App.kt - Shared app → Auth state: creates
app/shared/src/commonMain/kotlin/com/cloud/x/App.kt - Shared app → Storage view: creates
app/shared/src/commonMain/kotlin/com/cloud/x/App.kt - Authentication UI → Auth state: uses
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/AuthScreen.kt - Auth state → Authentication: calls
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/AuthViewModel.kt - Storage view → User profiles: observes
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt - Storage view → Quota calculations: calculates with
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/viewmodel/StorageViewModel.kt - Usage widget → Quota calculations: calculates with
app/shared/src/commonMain/kotlin/com/cloud/x/app/shared/ui/components/StorageBreakdownWidget.kt - User metadata → Quota calculations: formats using
core/src/commonMain/kotlin/com/cloud/x/model/UserMetadata.kt - File operations → Upload workflow: uses
core/src/commonMain/kotlin/com/cloud/x/repository/FileRepository.kt - File operations → File metadata: reads and writes
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
app/web-app/src/lib/upload-manager.ts - Web uploads → Activity logging: logs activity
app/web-app/src/lib/upload-manager.ts - Web uploads → Firebase setup: writes metadata
app/web-app/src/lib/upload-manager.ts - Web uploads → Supabase setup: uploads bytes
app/web-app/src/lib/upload-manager.ts - Web file manager → Firebase setup: reads and writes
app/web-app/src/lib/file-manager.ts - Activity logging → Firebase setup: uses
app/web-app/src/lib/activity-manager.ts - Web trash → Firebase setup: uses
app/web-app/src/lib/trash-manager.ts - Web trash → Activity logging: logs activity
app/web-app/src/lib/trash-manager.ts - Web trash → Web file manager: uses
app/web-app/src/lib/trash-manager.ts - Firebase setup → Firebase services: configures
app/web-app/src/lib/firebase.ts - Supabase setup → Supabase storage: configures