# purplemochii/screenshame architecture

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

- Interactive diagram: https://gitdiagram.com/purplemochii/screenshame
- Repository: https://github.com/purplemochii/screenshame

## Overview

ScreenShame appears to be an Android app for monitoring screen usage, with dashboard, history, limits, permissions, and login screens alongside local data and notification/widget utilities. The tree supports these component identities, but the README is empty and no application source was excerpted or indexed, so runtime flow and dependencies cannot be verified; no edges are asserted.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry and navigation"]
  node_main["Main activity<br/>[MainActivity.kt]"]
  node_application["Application setup"]
  node_navigation["App navigation<br/>[AppNavigation.kt]"]
  node_bottomnav["Bottom navigation<br/>[BottomNav.kt]"]
  node_icon["App icon component<br/>[AppIconCircle.kt]"]
  node_theme["App theme<br/>[Theme.kt]"]
end

subgraph group_screens["User screens"]
  node_dashboard["Dashboard<br/>[DashboardScreen.kt]"]
  node_history["Usage history<br/>[HistoryScreen.kt]"]
  node_limits["Usage limits<br/>[LimitsScreen.kt]"]
  node_login["Login<br/>[LoginScreen.kt]"]
  node_permissions["Permissions"]
end

subgraph group_data["Usage data"]
  node_viewmodel["Dashboard state"]
  node_repository["Usage repository<br/>[UsageRepository.kt]"]
  node_database[("App database<br/>[AppDatabase.kt]")]
end

subgraph group_services["Background and utility features"]
  node_auth["Authentication utility<br/>[AuthManager.kt]"]
  node_worker["Shame notifications"]
  node_widget["Usage widget"]
end

node_user(("User"))

click node_main "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/MainActivity.kt"
click node_application "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ScreenShameApplication.kt"
click node_navigation "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/navigation/AppNavigation.kt"
click node_bottomnav "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/components/BottomNav.kt"
click node_dashboard "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/DashboardScreen.kt"
click node_history "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/HistoryScreen.kt"
click node_limits "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/LimitsScreen.kt"
click node_login "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/LoginScreen.kt"
click node_permissions "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/PermissionScreen.kt"
click node_viewmodel "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/viewmodel/DashboardViewModel.kt"
click node_repository "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/data/repository/UsageRepository.kt"
click node_database "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/data/db/AppDatabase.kt"
click node_auth "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/util/AuthManager.kt"
click node_worker "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/util/ShameNotificationWorker.kt"
click node_widget "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/util/ScreenShameWidget.kt"
click node_icon "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/components/AppIconCircle.kt"
click node_theme "https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/theme/Theme.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_main,node_application,node_navigation,node_bottomnav,node_icon,node_theme,node_user toneBlue
class node_dashboard,node_history,node_limits,node_login,node_permissions toneAmber
class node_viewmodel,node_repository,node_database toneMint
class node_auth,node_worker,node_widget toneRose
```

## Components

### App entry and navigation

- [Main activity](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/MainActivity.kt): `app/src/main/java/com/example/screenshame/MainActivity.kt`
- [Application setup](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ScreenShameApplication.kt): `app/src/main/java/com/example/screenshame/ScreenShameApplication.kt`
- [App navigation](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/navigation/AppNavigation.kt): `app/src/main/java/com/example/screenshame/ui/navigation/AppNavigation.kt`
- [Bottom navigation](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/components/BottomNav.kt): `app/src/main/java/com/example/screenshame/ui/components/BottomNav.kt`
- [App icon component](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/components/AppIconCircle.kt): `app/src/main/java/com/example/screenshame/ui/components/AppIconCircle.kt`
- [App theme](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/theme/Theme.kt): `app/src/main/java/com/example/screenshame/ui/theme/Theme.kt`

### User screens

- [Dashboard](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/DashboardScreen.kt): `app/src/main/java/com/example/screenshame/ui/screens/DashboardScreen.kt`
- [Usage history](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/HistoryScreen.kt): `app/src/main/java/com/example/screenshame/ui/screens/HistoryScreen.kt`
- [Usage limits](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/LimitsScreen.kt): `app/src/main/java/com/example/screenshame/ui/screens/LimitsScreen.kt`
- [Login](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/LoginScreen.kt): `app/src/main/java/com/example/screenshame/ui/screens/LoginScreen.kt`
- [Permissions](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/screens/PermissionScreen.kt): `app/src/main/java/com/example/screenshame/ui/screens/PermissionScreen.kt`

### Usage data

- [Dashboard state](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/ui/viewmodel/DashboardViewModel.kt): `app/src/main/java/com/example/screenshame/ui/viewmodel/DashboardViewModel.kt`
- [Usage repository](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/data/repository/UsageRepository.kt): `app/src/main/java/com/example/screenshame/data/repository/UsageRepository.kt`
- [App database](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/data/db/AppDatabase.kt): `app/src/main/java/com/example/screenshame/data/db/AppDatabase.kt`

### Background and utility features

- [Authentication utility](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/util/AuthManager.kt): `app/src/main/java/com/example/screenshame/util/AuthManager.kt`
- [Shame notifications](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/util/ShameNotificationWorker.kt): `app/src/main/java/com/example/screenshame/util/ShameNotificationWorker.kt`
- [Usage widget](https://github.com/purplemochii/screenshame/blob/main/app/src/main/java/com/example/screenshame/util/ScreenShameWidget.kt): `app/src/main/java/com/example/screenshame/util/ScreenShameWidget.kt`

### Other components

- **User**
