# simone-05/app_ministart architecture

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

- Interactive diagram: https://gitdiagram.com/simone-05/app_ministart
- Repository: https://github.com/simone-05/app_ministart

## Overview

MiniStart is an Android home-screen launcher. Its main workflow is to show a home screen, open a searchable drawer of installed apps, and launch a selected app; users can also open settings to customize text and wallpaper. The graph preserves the settings and styling branch and the app-discovery/model/launch layers. Source excerpts support the principal calls; some home-screen details and wiring are supported only by the SOURCE INDEX, so unsampled behavior is not expanded beyond documented capabilities.

Main entry points: [`app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt`](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt) (Home activity), [`app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt`](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt) (App drawer), [`app/src/main/java/com/simonimal/ministart/apps/AppRepository.kt`](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/apps/AppRepository.kt) (Installed app repository), [`app/src/main/java/com/simonimal/ministart/ui/widgets/AppTextView.kt`](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/widgets/AppTextView.kt) (App text view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_home["Home screen"]
  node_home_activity["Home activity<br/>[HomeActivity.kt]"]
  node_drawer["App drawer<br/>[AppDrawer.kt]"]
end

subgraph group_apps["App discovery and launch"]
  node_repository["Installed app repository<br/>[AppRepository.kt]"]
  node_app_info["App metadata<br/>[AppInfo.kt]"]
  node_launcher["App launcher<br/>[AppLauncher.kt]"]
end

subgraph group_settings["Settings and styling"]
  node_settings_activity["Settings activity"]
  node_settings_main["Settings menu"]
  node_styling["Styling settings"]
end

subgraph group_shared["Shared UI and state"]
  node_prefs["Preferences keys<br/>[Prefs.kt]"]
  node_app_text["App text view<br/>[AppTextView.kt]"]
  node_animations["View animations<br/>[ViewAnimations.kt]"]
  node_home_gestures["Home gesture layout"]
  node_scroll_gestures["Nested scroll gestures"]
end

node_user(("User"))
node_device_apps(("Android app catalog"))
node_android(("Android system"))

node_user -.->|"opens launcher"| node_home_activity
node_home_activity -->|"creates and controls"| node_drawer
node_home_activity -->|"refreshes on package change"| node_repository
node_home_activity -->|"opens settings"| node_settings_activity
node_home_activity -->|"reads preferences"| node_prefs
node_home_activity -->|"handles gestures"| node_home_gestures
node_drawer -->|"uses nested gestures"| node_scroll_gestures
node_drawer -->|"searches app list"| node_repository
node_drawer -->|"launches single match"| node_launcher
node_drawer -->|"renders app entries"| node_app_text
node_repository -->|"queries launchable apps"| node_device_apps
node_repository -->|"creates app records"| node_app_info
node_app_text -->|"sets press animation"| node_animations
node_app_text -->|"starts selected app"| node_android
node_launcher -->|"starts package app"| node_android
node_settings_activity -->|"loads menu"| node_settings_main
node_settings_main -->|"opens styling"| node_styling
node_styling -->|"reads and writes settings"| node_prefs

click node_home_activity "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt"
click node_drawer "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt"
click node_settings_activity "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/settings/SettingsActivity.kt"
click node_settings_main "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/settings/SettingsMainFragment.kt"
click node_styling "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/settings/StylingSettingsFragment.kt"
click node_prefs "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/Prefs.kt"
click node_repository "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/apps/AppRepository.kt"
click node_app_info "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/model/AppInfo.kt"
click node_launcher "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/apps/AppLauncher.kt"
click node_app_text "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/widgets/AppTextView.kt"
click node_animations "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/animations/ViewAnimations.kt"
click node_home_gestures "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/widgets/GestureInterceptLayout.kt"
click node_scroll_gestures "https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/widgets/NestedScrollGesture.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_home_activity,node_drawer,node_user toneBlue
class node_repository,node_app_info,node_launcher toneAmber
class node_settings_activity,node_settings_main,node_styling toneMint
class node_prefs,node_app_text,node_animations,node_home_gestures,node_scroll_gestures toneRose
class node_device_apps,node_android toneIndigo
```

## Components

### Home screen

- [Home activity](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt): `app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt`
- [App drawer](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt): `app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt`

### App discovery and launch

- [Installed app repository](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/apps/AppRepository.kt): `app/src/main/java/com/simonimal/ministart/apps/AppRepository.kt`
- [App metadata](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/model/AppInfo.kt): `app/src/main/java/com/simonimal/ministart/model/AppInfo.kt`
- [App launcher](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/apps/AppLauncher.kt): `app/src/main/java/com/simonimal/ministart/apps/AppLauncher.kt`

### Settings and styling

- [Settings activity](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/settings/SettingsActivity.kt): `app/src/main/java/com/simonimal/ministart/activities/settings/SettingsActivity.kt`
- [Settings menu](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/settings/SettingsMainFragment.kt): `app/src/main/java/com/simonimal/ministart/activities/settings/SettingsMainFragment.kt`
- [Styling settings](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/activities/settings/StylingSettingsFragment.kt): `app/src/main/java/com/simonimal/ministart/activities/settings/StylingSettingsFragment.kt`

### Shared UI and state

- [Preferences keys](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/Prefs.kt): `app/src/main/java/com/simonimal/ministart/Prefs.kt`
- [App text view](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/widgets/AppTextView.kt): `app/src/main/java/com/simonimal/ministart/ui/widgets/AppTextView.kt`
- [View animations](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/animations/ViewAnimations.kt): `app/src/main/java/com/simonimal/ministart/ui/animations/ViewAnimations.kt`
- [Home gesture layout](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/widgets/GestureInterceptLayout.kt): `app/src/main/java/com/simonimal/ministart/ui/widgets/GestureInterceptLayout.kt`
- [Nested scroll gestures](https://github.com/simone-05/app_ministart/blob/main/app/src/main/java/com/simonimal/ministart/ui/widgets/NestedScrollGesture.kt): `app/src/main/java/com/simonimal/ministart/ui/widgets/NestedScrollGesture.kt`

### Other components

- **User**
- **Android app catalog**
- **Android system**

## Connections

- User → Home activity: opens launcher
- Home activity → App drawer: creates and controls (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt`)
- Home activity → Installed app repository: refreshes on package change (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt`)
- Home activity → Settings activity: opens settings (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt`)
- Home activity → Preferences keys: reads preferences (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt`)
- Home activity → Home gesture layout: handles gestures (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/HomeActivity.kt`)
- App drawer → Nested scroll gestures: uses nested gestures (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt`)
- App drawer → Installed app repository: searches app list (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt`)
- App drawer → App launcher: launches single match (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt`)
- App drawer → App text view: renders app entries (evidence: `app/src/main/java/com/simonimal/ministart/activities/home/AppDrawer.kt`)
- Installed app repository → Android app catalog: queries launchable apps (evidence: `app/src/main/java/com/simonimal/ministart/apps/AppRepository.kt`)
- Installed app repository → App metadata: creates app records (evidence: `app/src/main/java/com/simonimal/ministart/apps/AppRepository.kt`)
- App text view → View animations: sets press animation (evidence: `app/src/main/java/com/simonimal/ministart/ui/widgets/AppTextView.kt`)
- App text view → Android system: starts selected app (evidence: `app/src/main/java/com/simonimal/ministart/ui/widgets/AppTextView.kt`)
- App launcher → Android system: starts package app (evidence: `app/src/main/java/com/simonimal/ministart/apps/AppLauncher.kt`)
- Settings activity → Settings menu: loads menu (evidence: `app/src/main/java/com/simonimal/ministart/activities/settings/SettingsActivity.kt`)
- Settings menu → Styling settings: opens styling (evidence: `app/src/main/java/com/simonimal/ministart/activities/settings/SettingsMainFragment.kt`)
- Styling settings → Preferences keys: reads and writes settings (evidence: `app/src/main/java/com/simonimal/ministart/activities/settings/StylingSettingsFragment.kt`)
