# samuel-teshome/kiosk-app architecture

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

- Interactive diagram: https://gitdiagram.com/samuel-teshome/kiosk-app
- Repository: https://github.com/samuel-teshome/kiosk-app

## Overview

##### Project type and purpose
- This is a universal Expo (React Native) application that targets iOS, Android, and web.
- It uses file‐based routing (the **app** folder) and builds two flavors of web outputs—one under **kiosk** and a second under **kiosk-app**—for kiosk‐style static deployments.
- There is no bespoke backend in this repo; the app is a front-end only, likely consuming external APIs or media services.

##### File structure
- Top‐level folders:
- **app/**: your main source for screens and routing
- **components/**: reusable UI components (TypeScript & JSX)
- **assets/**: fonts, images, videos
- **kiosk/** & **kiosk-app/**: built static web outputs (HTML, JS bundles under `_expo/static/js/web`)
- **scripts/**: a reset script for scaffolding
- Config files: `package.json`, `tsconfig.json`, `tailwind.config.js`, `app.json` (Expo config)
- Build artifacts: inside each **_expo/static** folder lives the web runtime and per-vendor player scripts (YouTube, Twitch, etc.)

##### README
- Confirms an Expo project created via `create-expo-app`.
- File‐based routing under **app/**.
- Dev commands: `npm install`, `npx expo start`.
- No mention of backend—pure client.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Dev["Developer Workstation"]:::dev
    VC[".vscode/"]:::config
    Script["Reset Script (scripts/reset-project.js)"]:::config
    CLI["Expo CLI / Metro Bundler"]:::cli

    subgraph "App Source"
        App["Screens & Routing (app/)"]:::module
        Comp["UI Components (components/)"]:::module
        Hooks["Hooks & Theming (hooks/)"]:::module
        Assets["Assets (assets/)"]:::module
        Const["Constants (constants/Colors.ts)"]:::module
        ConfigExpo["Expo Config (app.json)"]:::config
        ConfigTS["TypeScript Config (tsconfig.json)"]:::config
        ConfigTailwind["Tailwind Config (tailwind.config.js)"]:::config
        ConfigPkg["Package Config (package.json)"]:::config
        ESLint["ESLint Config (eslint.config.js)"]:::config
    end

    subgraph "Build Outputs"
        Mobile["Mobile Bundles (iOS/Android)"]:::output
        subgraph "Static Deployment"
            Kiosk["Kiosk (kiosk/)"]:::output
            KioskApp["Kiosk-App (kiosk-app/)"]:::output
        end
    end

    Host["Static Host / CDN"]:::infra
    Services["External Media Services"]:::external

    Dev --> VC
    Dev --> Script
    Dev --> CLI
    CLI --> App
    CLI --> Comp
    CLI --> Hooks
    CLI --> Assets
    CLI --> Const
    CLI --> ConfigExpo
    CLI --> ConfigTS
    CLI --> ConfigTailwind
    CLI --> ConfigPkg
    CLI --> ESLint
    CLI --> Mobile
    CLI --> Kiosk
    CLI --> KioskApp
    Kiosk --> Host
    KioskApp --> Host
    Mobile --> Services
    Kiosk --> Services
    KioskApp --> Services

    click App "https://github.com/samuel-teshome/kiosk-app/tree/main/app/"
    click Comp "https://github.com/samuel-teshome/kiosk-app/tree/main/components/"
    click Hooks "https://github.com/samuel-teshome/kiosk-app/tree/main/hooks/"
    click Assets "https://github.com/samuel-teshome/kiosk-app/tree/main/assets/"
    click Const "https://github.com/samuel-teshome/kiosk-app/blob/main/constants/Colors.ts"
    click ConfigExpo "https://github.com/samuel-teshome/kiosk-app/blob/main/app.json"
    click ConfigTS "https://github.com/samuel-teshome/kiosk-app/blob/main/tsconfig.json"
    click ConfigTailwind "https://github.com/samuel-teshome/kiosk-app/blob/main/tailwind.config.js"
    click ConfigPkg "https://github.com/samuel-teshome/kiosk-app/blob/main/package.json"
    click Script "https://github.com/samuel-teshome/kiosk-app/blob/main/scripts/reset-project.js"
    click ESLint "https://github.com/samuel-teshome/kiosk-app/blob/main/eslint.config.js"
    click VC "https://github.com/samuel-teshome/kiosk-app/tree/main/.vscode/"
    click Kiosk "https://github.com/samuel-teshome/kiosk-app/tree/main/kiosk/"
    click KioskApp "https://github.com/samuel-teshome/kiosk-app/tree/main/kiosk-app/"

    classDef dev fill:#FFC66D,stroke:#333,stroke-width:1px
    classDef cli fill:#E7C6FF,stroke:#333,stroke-width:1px
    classDef module fill:#AEDFF7,stroke:#333,stroke-width:1px
    classDef config fill:#D5F5F6,stroke:#333,stroke-width:1px
    classDef output fill:#B7F7AE,stroke:#333,stroke-width:1px
    classDef infra fill:#DDDDDD,stroke:#333,stroke-width:1px
    classDef external fill:#EAEDED,stroke:#333,stroke-width:1px
```
