# makerbase-mks/mks-app architecture

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

- Interactive diagram: https://gitdiagram.com/makerbase-mks/mks-app
- Repository: https://github.com/makerbase-mks/mks-app

## Overview

1. This repository is not application source code; it is a distribution bundle for Makerbase MKS mobile apps. The only concrete artifacts present are Android APKs plus one PDF manual.

2. The repo splits into two product-specific subsystems:
   - `MKS Control/` for printer control
   - `MKS Laser/` for laser control

3. `MKS Control/` contains:
   - `printer_control.ui_1.2.1_3.apk` — an Android application package for the printer/control product line
   - `MKS APP软件说明书.pdf` — the end-user manual, which is part of the operating/documentation layer rather than the runtime system

4. `MKS Laser/` contains:
   - `MKSLaser.apk` — an Android application package for laser-device control

5. Architecturally, the APKs are the deployable runtime units. The likely interaction model is:
   - a user installs one of the APKs on an Android device
   - the app serves as the control client
   - it communicates with the corresponding MKS hardware device for configuration/operation
   The exact transport/protocol is not exposed in this repository.

6. The two APKs should be treated as separate bounded products, not as modules in a shared codebase. There is no visible shared library, backend service, or common source tree in this repo.

7. No server-side architecture is visible here. There are no APIs, databases, cloud services, CI/CD files, or build scripts in the repository contents provided. For an architecture diagram, this repo should be represented as a packaged-client artifact repository, not as a full system implementation.

8. The README is minimal and purely informational. It points to Makerbase community/support channels and does not define technical dependencies, deployment topology, or internal subsystem boundaries.

9. The PDF manual is the only non-binary support asset. It likely documents user workflows and device/app operation, so it belongs on the diagram as documentation/support material rather than a runtime dependency.

10. A clear architecture diagram for this repo would therefore show:
   - two independent Android app binaries
   - an Android user device as the runtime host
   - corresponding MKS hardware devices as external controlled targets
   - documentation/support as a side artifact
   - no visible backend or shared infrastructure within the repository

11. In short: this repository packages two standalone Android control applications for different MKS product lines, plus product documentation and community references. The system boundary ends at the APKs; everything else is external or not represented in source form.

Main entry points: [`MKS Control/printer_control.ui_1.2.1_3.apk`](https://github.com/makerbase-mks/mks-app/blob/HEAD/MKS%20Control/printer_control.ui_1.2.1_3.apk) (Printer App), [`MKS Laser/MKSLaser.apk`](https://github.com/makerbase-mks/mks-app/blob/HEAD/MKS%20Laser/MKSLaser.apk) (Laser App), [`MKS Control/MKS APP软件说明书.pdf`](https://github.com/makerbase-mks/mks-app/blob/HEAD/MKS%20Control/MKS%20APP%E8%BD%AF%E4%BB%B6%E8%AF%B4%E6%98%8E%E4%B9%A6.pdf) (Manual)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_repo["Repository"]
  node_repo_root["mks-app<br/>artifact repo"]
end

subgraph group_control["MKS Control"]
  node_control_apk["Printer App<br/>android apk"]
  node_control_manual["Manual<br/>pdf guide<br/>[MKS APP软件说明书.pdf]"]
end

subgraph group_laser["MKS Laser"]
  node_laser_apk["Laser App<br/>android apk<br/>[MKSLaser.apk]"]
end

subgraph group_external["External Runtime"]
  node_android_device(("Android Device<br/>runtime host"))
  node_printer_hw{{"Printer Device<br/>mks hardware"}}
  node_laser_hw{{"Laser Device<br/>mks hardware"}}
end

node_repo_root -->|"packages"| node_control_apk
node_repo_root -->|"includes"| node_control_manual
node_repo_root -->|"packages"| node_laser_apk
node_control_apk -->|"runs on"| node_android_device
node_laser_apk -->|"runs on"| node_android_device
node_control_apk -->|"controls"| node_printer_hw
node_laser_apk -->|"controls"| node_laser_hw

click node_control_apk "https://github.com/makerbase-mks/mks-app/blob/master/MKS Control/printer_control.ui_1.2.1_3.apk"
click node_control_manual "https://github.com/makerbase-mks/mks-app/blob/master/MKS Control/MKS APP软件说明书.pdf"
click node_laser_apk "https://github.com/makerbase-mks/mks-app/blob/master/MKS Laser/MKSLaser.apk"

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_repo_root toneBlue
class node_control_apk,node_control_manual toneAmber
class node_laser_apk toneMint
class node_android_device,node_printer_hw,node_laser_hw toneRose
```

## Components

### Repository

Packaged distribution contents for two MKS mobile control apps.

- **mks-app**: artifact repo · Distribution repository containing standalone Android app binaries and support material.

### MKS Control

Printer-control product bundle.

- [Printer App](https://github.com/makerbase-mks/mks-app/blob/HEAD/MKS%20Control/printer_control.ui_1.2.1_3.apk): android apk · Deployable Android client for the printer/control product line. · `MKS Control/printer_control.ui_1.2.1_3.apk`
- [Manual](https://github.com/makerbase-mks/mks-app/blob/HEAD/MKS%20Control/MKS%20APP%E8%BD%AF%E4%BB%B6%E8%AF%B4%E6%98%8E%E4%B9%A6.pdf): pdf guide · End-user operating manual for the MKS app and printer-control workflow. · `MKS Control/MKS APP软件说明书.pdf`

### MKS Laser

Laser-control product bundle.

- [Laser App](https://github.com/makerbase-mks/mks-app/blob/HEAD/MKS%20Laser/MKSLaser.apk): android apk · Deployable Android client for laser-device control. · `MKS Laser/MKSLaser.apk`

### External Runtime

Devices and host environment outside the repository.

- **Android Device**: runtime host · User-installed Android phone or tablet that runs one of the APKs.
- **Printer Device**: mks hardware · External printer hardware controlled by the printer app.
- **Laser Device**: mks hardware · External laser hardware controlled by the laser app.

## Connections

- mks-app → Printer App: packages · Repository distributes the printer-control APK.
- mks-app → Manual: includes · Repository also ships the user manual for the control app.
- mks-app → Laser App: packages · Repository distributes the laser-control APK.
- Printer App → Android Device: runs on · Printer-control app is installed and executed on an Android device.
- Laser App → Android Device: runs on · Laser-control app is installed and executed on an Android device.
- Printer App → Printer Device: controls · Printer app communicates with the corresponding MKS printer hardware.
- Laser App → Laser Device: controls · Laser app communicates with the corresponding MKS laser hardware.