# martinmimigames/little-file-explorer architecture

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

- Interactive diagram: https://gitdiagram.com/martinmimigames/little-file-explorer
- Repository: https://github.com/martinmimigames/little-file-explorer

## Overview

##### Project Type and Purpose
- This is a single-module Android mobile application (“Little File Explorer”) written in Java/Kotlin under Gradle.
- Purpose: provide a lightweight (<40 KB), fully open-source file-explorer on Android (CRUD file operations, sorting, multi-share, MD5 checksum, theme toggles).

##### File Structure Analysis
- Top‐level:
- CI/CD: `.github/workflows/build.yml`, `Dockerfile`
- Metadata & release: `fastlane/metadata/...` (F-Droid/App store)
- Gradle configs: `build.gradle`, `settings.gradle`, `gradle.properties`, `gradle/wrapper`
- `app/` module:
- `src/main/java/com/martinmimigames/simplefileexplorer/`:
– **UI layer:** `MainActivity.java`, dialog containers (`DeleteConfirmationDialogContainer`, `DetailsDialogContainer`, `OpenListDialogContainer`), `layout` subpackage.
– **View components:** `view/ItemView.java`.
– **Business logic:** `FileOperation.java`, `FileOpener.java`, `PermissionManager.java`, `Preferences.java`.
– **FileProvider:** abstraction over Android’s file APIs.
- `src/main/res/`: layouts (`activity_main.xml`, etc.), drawables, theme definitions.
- Git submodule: `mg/utils` for cross-cutting utilities.

##### README Insights
- Android SDK & OpenJDK-17 build (also Dockerfile supplied).
- Uses standard Android patterns (Activities, ContentProviders, Intents).
- Fastlane metadata for multilingual release process.

a. Main Components
1. Presentation Layer (UI)
– MainActivity & XML layouts
– Dialog containers & custom views
2. Business Logic Layer
– FileOperation (copy/paste/delete/rename)
– PermissionManager (runtime storage permissions)
– Preferences (theme, filters)
– FileOpener (Intent dispatch)
3. Data/Storage Layer
– Android File System (internal & SD volumes)
– ContentProvider abstraction (`FileProvider.java`)
– mg.utils library
4. External Interfaces
– Other Apps (via Intents for “Open with…” & multi-share)
– Android OS services (Storage Manager, Clipboard)
5. CI/CD Pipeline (build & release)
– GitHub Actions → Docker build → Gradle assemble → Fastlane → F-Droid/GitHub Releases

b. Relationships & Data Flows
- User taps UI → MainActivity routes to Business Logic
- Business Logic checks permissions via PermissionManager → requests/storage granted by OS
- FileOperation uses FileProvider → reads/writes file system → updates UI via callbacks
- FileOpener issues Intent → external apps consume file URI
- Preferences persisted in SharedPreferences → influences UI (theme, sort order)
- CI/CD: commits → GitHub Actions triggers Docker container → Gradle build → Fastlane pushes APK to stores

c. Architectural Patterns & Principles
- Layered MVC/MVP approach: Activities as controllers, XML as views, Java classes encapsulate model/business logic
- Clean separation of concerns: UI ↔ business ↔ data
- Use of Android framework components (ContentProvider, Intents)
- Git submodule for modular utility code

d. Key Technologies & Frameworks
- Android SDK (Activities, Content Providers, SharedPreferences, Intents)
- Gradle build system
- Docker for consistent build env
- GitHub Actions for CI
- Fastlane for package metadata & release
- mg.utils (utility submodule)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI Layer"
        MA["MainActivity"]:::ui
        XML["XML Layouts"]:::ui
        DCDC["DeleteConfirmationDialogContainer"]:::ui
        DDLC["DetailsDialogContainer"]:::ui
        OLDC["OpenListDialogContainer"]:::ui
        IV["ItemView"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        FO["FileOperation"]:::business
        FOP["FileOpener"]:::business
        PM["PermissionManager"]:::business
        Prefs["Preferences"]:::business
        MGU["mg.utils"]:::business
    end

    %% Data & Storage Layer
    subgraph "Data & Storage Layer"
        FP["FileProvider"]:::data
        SP["SharedPreferences"]:::data
        FS["Android File System"]:::data
        AM["AndroidManifest"]:::data
    end

    %% OS and External
    OS["Android OS"]:::external
    EA["External Apps"]:::external

    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline"
        CI["Repository"]:::cicd
        GA["GitHub Actions"]:::cicd
        DK["Docker"]:::cicd
        GBU["Gradle Build"]:::cicd
        FL["Fastlane"]:::cicd
        STR["App Stores"]:::cicd
    end

    %% Data Flows
    MA -->|"invokes"| FO
    MA -->|loads layouts| XML
    MA -->|opens dialogs| DCDC
    MA -->|opens dialogs| DDLC
    MA -->|opens dialogs| OLDC
    MA -->|renders items| IV

    FO -->|"uses"| FP
    FO -->|"updates UI"| MA

    FP -->|reads/writes| FS
    FS -->|managed by| OS

    PM -->|"requests"| OS
    Prefs -->|persists settings| SP
    SP -->|stored in| OS

    FOP -->|"dispatches Intent"| OS
    OS -->|"delivers to"| EA

    MGU -->|"utilities for"| FO
    MGU -->|"utilities for"| PM
    MGU -->|"utilities for"| Prefs

    %% CI/CD Flows
    CI -->|"push"| GA
    GA -->|builds in| DK
    DK -->|"runs"| GBU
    GBU -->|"publishes via"| FL
    FL -->|"deploys to"| STR

    %% Click Events
    click MA "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/MainActivity.java"
    click XML "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/res/layout/activity_main.xml"
    click DCDC "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/layout/DeleteConfirmationDialogContainer.java"
    click DDLC "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/layout/DetailsDialogContainer.java"
    click OLDC "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/layout/OpenListDialogContainer.java"
    click IV "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/view/ItemView.java"
    click FO "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/FileOperation.java"
    click FOP "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/FileOpener.java"
    click PM "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/PermissionManager.java"
    click Prefs "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/Preferences.java"
    click FP "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/java/com/martinmimigames/simplefileexplorer/FileProvider.java"
    click AM "https://github.com/martinmimigames/little-file-explorer/blob/main/app/src/main/AndroidManifest.xml"
    click MGU "https://github.com/martinmimigames/little-file-explorer/tree/main/app/src/main/java/mg/utils"
    click GA "https://github.com/martinmimigames/little-file-explorer/blob/main/.github/workflows/build.yml"
    click DK "https://github.com/martinmimigames/little-file-explorer/tree/main/Dockerfile"
    click FL "https://github.com/martinmimigames/little-file-explorer/tree/main/fastlane/metadata/android"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef business fill:#90EE90,stroke:#333,stroke-width:1px
    classDef data fill:#FFA500,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef cicd fill:#DDA0DD,stroke:#333,stroke-width:1px
```
