# fahmymahmoud27/meditation-app architecture

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

- Interactive diagram: https://gitdiagram.com/fahmymahmoud27/meditation-app
- Repository: https://github.com/fahmymahmoud27/meditation-app

## Overview

This repository is a small Android meditation-app project whose implemented product surface is an authentication UI: users arrive at login, can navigate to sign-up, and enter account details in Compose forms. The sampled code shows presentation and route navigation, but no authentication service, persistence, or meditation-session features; social-login and submit actions are currently empty callbacks. The map focuses on the implemented runtime. Relationships are limited to calls and route transitions visible in the excerpts.

Main entry points: [`app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt`](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt) (Sign-up screen), [`app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt`](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt) (Login screen), [`app/src/main/java/com/linkdevelopment/meditationapp/utils/AppNavigation.kt`](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/utils/AppNavigation.kt) (App navigation), [`app/src/main/java/com/linkdevelopment/meditationapp/MainActivity.kt`](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/MainActivity.kt) (Main activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavigation.kt]"]
end

subgraph group_auth["Authentication screens"]
  node_login["Login screen<br/>[LoginScreen.kt]"]
  node_signup["Sign-up screen<br/>[SignUpScreen.kt]"]
end

subgraph group_ui["Reusable UI and theme"]
  node_fields["Auth text fields<br/>[TextFields.kt]"]
  node_buttons["Auth buttons<br/>[ButtonFields.kt]"]
  node_theme["App theme<br/>[Theme.kt]"]
  node_colors["Color palette<br/>[Color.kt]"]
  node_typography["Typography<br/>[Type.kt]"]
end

node_user(("App user"))

node_user -->|"opens app"| node_activity
node_activity -->|"applies theme"| node_theme
node_activity -->|"starts navigation"| node_navigation
node_navigation -->|"routes to"| node_login
node_navigation -->|"routes to"| node_signup
node_login -->|"navigates to"| node_signup
node_signup -->|"requests route"| node_navigation
node_login -->|"renders"| node_fields
node_login -->|"renders"| node_buttons
node_signup -->|"renders"| node_fields
node_signup -->|"renders"| node_buttons
node_theme -->|"uses palette"| node_colors
node_theme -->|"uses styles"| node_typography

click node_activity "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/MainActivity.kt"
click node_navigation "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/utils/AppNavigation.kt"
click node_login "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt"
click node_signup "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt"
click node_fields "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/utils/TextFields.kt"
click node_buttons "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/utils/ButtonFields.kt"
click node_theme "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Theme.kt"
click node_colors "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Color.kt"
click node_typography "https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Type.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_user toneBlue
class node_login,node_signup toneAmber
class node_fields,node_buttons,node_theme,node_colors,node_typography toneMint
```

## Components

### App shell

- [Main activity](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/MainActivity.kt): `app/src/main/java/com/linkdevelopment/meditationapp/MainActivity.kt`
- [App navigation](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/utils/AppNavigation.kt): `app/src/main/java/com/linkdevelopment/meditationapp/utils/AppNavigation.kt`

### Authentication screens

- [Login screen](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt): `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt`
- [Sign-up screen](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt): `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt`

### Reusable UI and theme

- [Auth text fields](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/utils/TextFields.kt): `app/src/main/java/com/linkdevelopment/meditationapp/utils/TextFields.kt`
- [Auth buttons](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/utils/ButtonFields.kt): `app/src/main/java/com/linkdevelopment/meditationapp/utils/ButtonFields.kt`
- [App theme](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Theme.kt): `app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Theme.kt`
- [Color palette](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Color.kt): `app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Color.kt`
- [Typography](https://github.com/fahmymahmoud27/meditation-app/blob/master/app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Type.kt): `app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Type.kt`

### Other components

- **App user**

## Connections

- App user → Main activity: opens app
- Main activity → App theme: applies theme (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/MainActivity.kt`)
- Main activity → App navigation: starts navigation (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/MainActivity.kt`)
- App navigation → Login screen: routes to (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/utils/AppNavigation.kt`)
- App navigation → Sign-up screen: routes to (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/utils/AppNavigation.kt`)
- Login screen → Sign-up screen: navigates to (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt`)
- Sign-up screen → App navigation: requests route (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt`)
- Login screen → Auth text fields: renders (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt`)
- Login screen → Auth buttons: renders (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/login/LoginScreen.kt`)
- Sign-up screen → Auth text fields: renders (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt`)
- Sign-up screen → Auth buttons: renders (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/screens/signup/SignUpScreen.kt`)
- App theme → Color palette: uses palette (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Theme.kt`)
- App theme → Typography: uses styles (evidence: `app/src/main/java/com/linkdevelopment/meditationapp/ui/theme/Theme.kt`)
