# solankidushyant07/gallerymanager architecture

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

- Interactive diagram: https://gitdiagram.com/solankidushyant07/gallerymanager
- Repository: https://github.com/solankidushyant07/gallerymanager

## Overview

Gallery Manager is an Android image/video gallery. The user enters through the app’s navigation, browses or searches public media, and can organize, edit, compose, protect, or remove items. Public media is sourced from MediaStore and indexed locally; app-managed collections and feature state use Room. The README documents non-destructive editing, centralized file operations with conflict handling and Undo, and 30-day Trash. Several feature screens and their wiring are unsampled, so those connections are shown as unverified rather than asserted as calls.

Main entry points: [`app/src/main/java/com/coconutshell/gallerymanager/core/database/GalleryDatabase.kt`](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/database/GalleryDatabase.kt) (Room database), [`app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeScreen.kt`](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeScreen.kt) (Home browser), [`app/src/main/java/com/coconutshell/gallerymanager/core/trash/TrashService.kt`](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/trash/TrashService.kt) (30-day Trash), [`app/src/main/java/com/coconutshell/gallerymanager/core/privatevault/PrivateVaultService.kt`](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/privatevault/PrivateVaultService.kt) (Private vault)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and browsing"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavHost.kt]"]
  node_home["Home browser<br/>[HomeScreen.kt]"]
  node_homevm["Home state<br/>[HomeViewModel.kt]"]
  node_search["Media search<br/>[SearchScreen.kt]"]
  node_settings["Settings screen<br/>[SettingsScreen.kt]"]
end

subgraph group_media["Media and operations"]
  node_searchrepo["Search repository"]
  node_permissions["Media permissions"]
  node_storage["Media index"]
  node_mediasource["MediaStore source"]
  node_fileops["File operations"]
  node_editor["Image editor"]
  node_viewer["Media viewer<br/>[ViewerScreen.kt]"]
end

subgraph group_collections["Collections and projects"]
  node_albums["Virtual albums<br/>[AlbumService.kt]"]
  node_favorites["Favorites"]
  node_composition["Composition projects"]
  node_trash["30-day Trash<br/>[TrashService.kt]"]
  node_vault["Private vault"]
end

subgraph group_state["Local state"]
  node_database[("Room database<br/>[GalleryDatabase.kt]")]
  node_preferences["Gallery preferences"]
end

node_user(("Gallery user"))
node_mediastore[("Android MediaStore")]
node_keystore[("Android Keystore")]

node_user -.->|"opens"| node_activity
node_activity -->|"hosts"| node_navigation
node_user -.->|"browses"| node_home
node_home -->|"uses state"| node_homevm
node_home -->|"checks access"| node_permissions
node_user -.->|"searches"| node_search
node_search -->|"queries"| node_searchrepo
node_searchrepo -.->|"searches files"| node_database
node_storage -->|"scans"| node_mediasource
node_storage -->|"reconciles index"| node_database
node_mediasource -.->|"reads media"| node_mediastore
node_user -.->|"manages files"| node_fileops
node_user -.->|"edits images"| node_editor
node_user -.->|"views media"| node_viewer
node_user -.->|"organizes albums"| node_albums
node_albums -.->|"stores albums"| node_database
node_user -.->|"marks favorites"| node_favorites
node_favorites -.->|"stores favorites"| node_database
node_user -.->|"creates compositions"| node_composition
node_composition -.->|"saves projects"| node_database
node_user -.->|"trashes media"| node_trash
node_trash -.->|"stores trash state"| node_database
node_trash -.->|"restores media"| node_mediastore
node_user -.->|"protects media"| node_vault
node_vault -.->|"stores metadata"| node_database
node_vault -.->|"encrypts with"| node_keystore
node_user -.->|"configures"| node_settings
node_settings -.->|"updates preferences"| node_preferences

click node_activity "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/MainActivity.kt"
click node_navigation "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/shared/navigation/AppNavHost.kt"
click node_home "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeScreen.kt"
click node_homevm "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeViewModel.kt"
click node_search "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/search/SearchScreen.kt"
click node_searchrepo "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/search/SearchRepository.kt"
click node_permissions "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/permissions/MediaPermissionManager.kt"
click node_storage "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/storage/StorageRepository.kt"
click node_mediasource "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/storage/MediaStoreDataSource.kt"
click node_fileops "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/fileoperations/FileOperationService.kt"
click node_editor "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/editor/ImageEditorScreen.kt"
click node_viewer "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/viewer/ViewerScreen.kt"
click node_albums "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/albums/AlbumService.kt"
click node_favorites "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/favorites/FavoritesService.kt"
click node_composition "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/composition/CompositionService.kt"
click node_trash "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/trash/TrashService.kt"
click node_vault "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/privatevault/PrivateVaultService.kt"
click node_database "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/database/GalleryDatabase.kt"
click node_preferences "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/preferences/PreferencesRepository.kt"
click node_settings "https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/settings/SettingsScreen.kt"

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_activity,node_navigation,node_home,node_homevm,node_search,node_settings,node_user toneBlue
class node_searchrepo,node_permissions,node_storage,node_mediasource,node_fileops,node_editor,node_viewer,node_mediastore,node_keystore toneAmber
class node_albums,node_favorites,node_composition,node_trash,node_vault toneMint
class node_database,node_preferences toneRose
```

## Components

### App and browsing

- [Main activity](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/MainActivity.kt): `app/src/main/java/com/coconutshell/gallerymanager/MainActivity.kt`
- [App navigation](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/shared/navigation/AppNavHost.kt): `app/src/main/java/com/coconutshell/gallerymanager/shared/navigation/AppNavHost.kt`
- [Home browser](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeScreen.kt): `app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeScreen.kt`
- [Home state](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeViewModel.kt): `app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeViewModel.kt`
- [Media search](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/search/SearchScreen.kt): `app/src/main/java/com/coconutshell/gallerymanager/feature/search/SearchScreen.kt`
- [Settings screen](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/settings/SettingsScreen.kt): `app/src/main/java/com/coconutshell/gallerymanager/feature/settings/SettingsScreen.kt`

### Media and operations

- [Search repository](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/search/SearchRepository.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/search/SearchRepository.kt`
- [Media permissions](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/permissions/MediaPermissionManager.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/permissions/MediaPermissionManager.kt`
- [Media index](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/storage/StorageRepository.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/storage/StorageRepository.kt`
- [MediaStore source](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/storage/MediaStoreDataSource.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/storage/MediaStoreDataSource.kt`
- [File operations](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/fileoperations/FileOperationService.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/fileoperations/FileOperationService.kt`
- [Image editor](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/editor/ImageEditorScreen.kt): `app/src/main/java/com/coconutshell/gallerymanager/feature/editor/ImageEditorScreen.kt`
- [Media viewer](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/feature/viewer/ViewerScreen.kt): `app/src/main/java/com/coconutshell/gallerymanager/feature/viewer/ViewerScreen.kt`

### Collections and projects

- [Virtual albums](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/albums/AlbumService.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/albums/AlbumService.kt`
- [Favorites](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/favorites/FavoritesService.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/favorites/FavoritesService.kt`
- [Composition projects](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/composition/CompositionService.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/composition/CompositionService.kt`
- [30-day Trash](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/trash/TrashService.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/trash/TrashService.kt`
- [Private vault](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/privatevault/PrivateVaultService.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/privatevault/PrivateVaultService.kt`

### Local state

- [Room database](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/database/GalleryDatabase.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/database/GalleryDatabase.kt`
- [Gallery preferences](https://github.com/solankidushyant07/gallerymanager/blob/main/app/src/main/java/com/coconutshell/gallerymanager/core/preferences/PreferencesRepository.kt): `app/src/main/java/com/coconutshell/gallerymanager/core/preferences/PreferencesRepository.kt`

### Other components

- **Gallery user**
- **Android MediaStore**
- **Android Keystore**

## Connections

- Gallery user → Main activity: opens
- Main activity → App navigation: hosts (evidence: `app/src/main/java/com/coconutshell/gallerymanager/MainActivity.kt`)
- Gallery user → Home browser: browses
- Home browser → Home state: uses state (evidence: `app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeScreen.kt`)
- Home browser → Media permissions: checks access (evidence: `app/src/main/java/com/coconutshell/gallerymanager/feature/home/HomeScreen.kt`)
- Gallery user → Media search: searches
- Media search → Search repository: queries (evidence: `app/src/main/java/com/coconutshell/gallerymanager/feature/search/SearchScreen.kt`)
- Search repository → Room database: searches files
- Media index → MediaStore source: scans (evidence: `app/src/main/java/com/coconutshell/gallerymanager/core/storage/StorageRepository.kt`)
- Media index → Room database: reconciles index (evidence: `app/src/main/java/com/coconutshell/gallerymanager/core/storage/StorageRepository.kt`)
- MediaStore source → Android MediaStore: reads media
- Gallery user → File operations: manages files (evidence: `README.md`)
- Gallery user → Image editor: edits images (evidence: `README.md`)
- Gallery user → Media viewer: views media
- Gallery user → Virtual albums: organizes albums (evidence: `README.md`)
- Virtual albums → Room database: stores albums
- Gallery user → Favorites: marks favorites (evidence: `README.md`)
- Favorites → Room database: stores favorites
- Gallery user → Composition projects: creates compositions (evidence: `README.md`)
- Composition projects → Room database: saves projects
- Gallery user → 30-day Trash: trashes media (evidence: `README.md`)
- 30-day Trash → Room database: stores trash state
- 30-day Trash → Android MediaStore: restores media
- Gallery user → Private vault: protects media (evidence: `README.md`)
- Private vault → Room database: stores metadata
- Private vault → Android Keystore: encrypts with
- Gallery user → Settings screen: configures
- Settings screen → Gallery preferences: updates preferences
