# dylpark/kids-drawing-app-android architecture

> Architecture diagram of the GitHub repository dylpark/kids-drawing-app-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dylpark/kids-drawing-app-android
- Repository: https://github.com/dylpark/kids-drawing-app-android

## Overview

##### Project type and purpose
- This is a single-module Android mobile application (“Kids Drawing App”) written in Kotlin.

##### File structure
- Top-level build files (build.gradle, settings.gradle, gradle folder, gradlew) indicate a standard Gradle-based Android project.
- “app” module holds all source code and resources.
- src/main/java/com/kidsdrawingapp: MainActivity.kt and DrawingView.kt implement UI and drawing logic.
- src/androidTest & src/test: instrumentation and unit tests.
- ProGuard config, manifest, and Gradle wrapper are present—no separate backend or microservices.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI Layer"
        MainActivity["MainActivity"]:::ui
        ActivityLayout["activity_main.xml"]:::ui
        BrushSizeDialog["dialog_brush_size.xml"]:::ui
        ProgressDialog["dialog_custom_progress.xml"]:::ui
        Snackbar["Snackbar Notifications"]:::ui
    end

    %% Drawing Engine
    subgraph "Drawing Engine"
        DrawingView["DrawingView"]:::engine
        PathManager["PathManager (in-memory)"]:::engine
    end

    %% Business Logic
    subgraph "Business Logic"
        BrushSizeSelector["BrushSizeSelector"]:::logic
        ColorPalette["ColorPalette"]:::logic
    end

    %% Services & I/O
    subgraph "Services & I/O"
        FileIOService["File I/O Service"]:::service
        AsyncTask["AsyncTask (Background)"]:::service
        ShareService["Share Service"]:::service
    end

    %% Android OS & External
    subgraph "Android OS & External"
        CanvasAPI["Android Canvas API"]:::external
        PermissionManager["Permission Manager"]:::external
        ExternalStorage["External Storage"]:::external
        ShareIntent["Share Intent"]:::external
    end

    %% Relationships
    MainActivity -->|"hosts"| ActivityLayout
    MainActivity -->|"launches"| BrushSizeDialog
    MainActivity -->|"launches"| ProgressDialog
    MainActivity -->|"shows"| Snackbar

    MainActivity -->|"contains touch events"| DrawingView
    DrawingView -->|"updates"| PathManager
    DrawingView -->|"draws on"| CanvasAPI

    MainActivity -->|"uses"| BrushSizeSelector
    MainActivity -->|"uses"| ColorPalette

    MainActivity -->|"triggers save"| FileIOService
    FileIOService -->|"executes on"| AsyncTask
    AsyncTask -->|"writes to"| ExternalStorage
    AsyncTask -->|"callback"| MainActivity

    MainActivity -->|"triggers share"| ShareService
    ShareService -->|"invokes"| ShareIntent

    MainActivity -->|"requests"| PermissionManager
    PermissionManager -->|"grants"| MainActivity

    %% Click Events
    click MainActivity "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/java/com/kidsdrawingapp/MainActivity.kt"
    click DrawingView "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/java/com/kidsdrawingapp/DrawingView.kt"
    click ActivityLayout "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/res/layout/activity_main.xml"
    click BrushSizeDialog "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/res/layout/dialog_brush_size.xml"
    click ProgressDialog "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/res/layout/dialog_custom_progress.xml"
    click ExternalStorage "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/AndroidManifest.xml"
    click PermissionManager "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/java/com/kidsdrawingapp/MainActivity.kt"
    click FileIOService "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/java/com/kidsdrawingapp/MainActivity.kt"
    click ShareService "https://github.com/dylpark/kids-drawing-app-android/blob/main/app/src/main/java/com/kidsdrawingapp/MainActivity.kt"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef engine fill:#E6FFED,stroke:#28A745,color:#28A745;
    classDef logic fill:#ECFFD0,stroke:#8FBC00,color:#8FBC00;
    classDef service fill:#FFE8D0,stroke:#D2691E,color:#D2691E;
    classDef external fill:#F0F0F0,stroke:#6A737D,color:#6A737D;
```
