# goku673/exaumss architecture

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

- Interactive diagram: https://gitdiagram.com/goku673/exaumss
- Repository: https://github.com/goku673/exaumss

## Overview

##### Project type and purpose
- This is a universal (iOS, Android, Web) mobile app built with Expo and React Native, generated via `create-expo-app`.
- Its primary purpose is to serve as a client-side application with file-based routing, theming, and reusable UI components—no dedicated backend or microservices are included in this repo.

##### File structure
- Top-level directories:
- `app/` – contains all routes and layouts using Expo’s file-based routing.
- `components/` – reusable UI controls, theming wrappers, and custom hooks under `components/ui`.
- `assets/` – static resources (fonts, images).
- `scripts/` – helper scripts (e.g., `reset-project.js`).
- Key config/build files: `app.json`, `tsconfig.json`, `package.json`, `package-lock.json`.
- Platform-specific variants: files like `IconSymbol.ios.tsx` vs `IconSymbol.tsx`, indicating conditional bundling.

##### README for additional insights
- Confirms use of Expo, TypeScript, file-based routing, and recommended workflows (start, reset).
- No mention of any backend or external APIs, so the current architecture is purely frontend.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Runtime Layer
    User["User Device"]:::runtime
    ExpoRuntime["Expo Runtime / Native Shell"]:::runtime
    User -->|"tap event"| ExpoRuntime

    %% Framework Layer
    RNModules["React Native & Expo Modules"]:::framework
    ExpoRuntime -->|"bridges to"| RNModules

    %% Application Layer
    subgraph "Routing Layer"
        direction TB
        RL_layout["Layout: app/_layout.tsx"]:::application
        RL_tabs_layout["Layout: app/(tabs)/_layout.tsx"]:::application
        RL_index["Screen: app/(tabs)/index.tsx"]:::application
        RL_explore["Screen: app/(tabs)/explore.tsx"]:::application
        RL_notfound["Screen: app/+not-found.tsx"]:::application
    end
    RNModules -->|"file-based routing"| RL_layout
    RL_layout --> RL_tabs_layout
    RL_tabs_layout --> RL_index
    RL_tabs_layout --> RL_explore
    RL_layout --> RL_notfound

    subgraph "UI Components"
        direction TB
        Collapsible["Collapsible"]:::application
        ExternalLink["ExternalLink"]:::application
        HapticTab["HapticTab"]:::application
        HelloWave["HelloWave"]:::application
        ParallaxScrollView["ParallaxScrollView"]:::application
        ThemedText["ThemedText"]:::application
        ThemedView["ThemedView"]:::application
        IconSymbol_ios["IconSymbol.ios"]:::application
        IconSymbol["IconSymbol"]:::application
        TabBarBackground_ios["TabBarBackground.ios"]:::application
        TabBarBackground["TabBarBackground"]:::application
    end
    RL_index -->|"uses"| Collapsible
    RL_index -->|"uses"| ExternalLink
    RL_explore -->|"uses"| HelloWave

    subgraph "Theming Engine"
        direction TB
        ColorScheme["useColorScheme.ts"]:::application
        ColorSchemeWeb["useColorScheme.web.ts"]:::application
        ThemeColor["useThemeColor.ts"]:::application
        Colors["constants/Colors.ts"]:::application
    end
    Collapsible -->|"calls"| ThemeColor
    ExternalLink -->|"calls"| ColorScheme
    ThemeColor -->|"reads"| Colors
    ColorScheme -->|"variant web"| ColorSchemeWeb

    subgraph "Assets Store"
        direction TB
        Fonts["Fonts (assets/fonts/)"]:::assets
        Images["Images (assets/images/)"]:::assets
    end
    HapticTab -->|"loads asset"| Sounds
    ParallaxScrollView -->|"loads image"| Images
    HelloWave -->|"uses font"| Fonts

    subgraph "Build & Dev Tools"
        direction TB
        PackageJSON["package.json"]:::tools
        PackageLock["package-lock.json"]:::tools
        TSConfig["tsconfig.json"]:::tools
        AppJSON["app.json"]:::tools
        ResetScript["reset-project.js"]:::tools
    end
    BuildTools(["Build & Dev Tools"]):::tools
    BuildTools -->|"runs"| ExpoRuntime
    PackageJSON --> BuildTools
    PackageLock --> BuildTools
    TSConfig --> BuildTools
    AppJSON --> BuildTools
    ResetScript --> BuildTools

    %% Click Events - Routing Layer
    click RL_layout "https://github.com/goku673/exaumss/blob/main/app/_layout.tsx"
    click RL_tabs_layout "https://github.com/goku673/exaumss/blob/main/app/(tabs)/_layout.tsx"
    click RL_index "https://github.com/goku673/exaumss/blob/main/app/(tabs)/index.tsx"
    click RL_explore "https://github.com/goku673/exaumss/blob/main/app/(tabs)/explore.tsx"
    click RL_notfound "https://github.com/goku673/exaumss/blob/main/app/+not-found.tsx"

    %% Click Events - UI Components
    click Collapsible "https://github.com/goku673/exaumss/blob/main/components/Collapsible.tsx"
    click ExternalLink "https://github.com/goku673/exaumss/blob/main/components/ExternalLink.tsx"
    click HapticTab "https://github.com/goku673/exaumss/blob/main/components/HapticTab.tsx"
    click HelloWave "https://github.com/goku673/exaumss/blob/main/components/HelloWave.tsx"
    click ParallaxScrollView "https://github.com/goku673/exaumss/blob/main/components/ParallaxScrollView.tsx"
    click ThemedText "https://github.com/goku673/exaumss/blob/main/components/ThemedText.tsx"
    click ThemedView "https://github.com/goku673/exaumss/blob/main/components/ThemedView.tsx"
    click IconSymbol_ios "https://github.com/goku673/exaumss/blob/main/components/ui/IconSymbol.ios.tsx"
    click IconSymbol "https://github.com/goku673/exaumss/blob/main/components/ui/IconSymbol.tsx"
    click TabBarBackground_ios "https://github.com/goku673/exaumss/blob/main/components/ui/TabBarBackground.ios.tsx"
    click TabBarBackground "https://github.com/goku673/exaumss/blob/main/components/ui/TabBarBackground.tsx"

    %% Click Events - Theming Engine
    click ColorScheme "https://github.com/goku673/exaumss/blob/main/hooks/useColorScheme.ts"
    click ColorSchemeWeb "https://github.com/goku673/exaumss/blob/main/hooks/useColorScheme.web.ts"
    click ThemeColor "https://github.com/goku673/exaumss/blob/main/hooks/useThemeColor.ts"
    click Colors "https://github.com/goku673/exaumss/blob/main/constants/Colors.ts"

    %% Click Events - Assets Store
    click Fonts "https://github.com/goku673/exaumss/tree/main/assets/fonts/"
    click Images "https://github.com/goku673/exaumss/tree/main/assets/images/"

    %% Click Events - Build & Dev Tools
    click PackageJSON "https://github.com/goku673/exaumss/blob/main/package.json"
    click PackageLock "https://github.com/goku673/exaumss/blob/main/package-lock.json"
    click TSConfig "https://github.com/goku673/exaumss/blob/main/tsconfig.json"
    click AppJSON "https://github.com/goku673/exaumss/blob/main/app.json"
    click ResetScript "https://github.com/goku673/exaumss/blob/main/scripts/reset-project.js"

    %% Styles
    classDef runtime fill:#dddddd,stroke:#888888;
    classDef framework fill:#bbe1fa,stroke:#1b6ca8,color:#000000;
    classDef application fill:#b2fab4,stroke:#2f8f2f;
    classDef assets fill:#ffddb3,stroke:#cc9a06;
    classDef tools fill:#ffd6e0,stroke:#d04861;
    class BuildTools tools
```
