# smailmelki/melkicad architecture

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

- Interactive diagram: https://gitdiagram.com/smailmelki/melkicad
- Repository: https://github.com/smailmelki/melkicad

## Overview

MelkiCAD is an offline-capable Arabic room and home plan editor, delivered as a browser PWA with an Android Capacitor wrapper. The user draws and edits a plan on the canvas, organizes it into projects and layers, then saves or exports it as JSON/DXF or a print-ready PDF. The graph preserves the documented editing, import/export, print, settings, and offline branches. JavaScript files share a global scope; unsampled call relationships are omitted rather than inferred from file order.

Main entry points: [`src/js/13-draw-input.js`](https://github.com/smailmelki/melkicad/blob/main/src/js/13-draw-input.js) (Drawing tools), [`src/js/00-storage.js`](https://github.com/smailmelki/melkicad/blob/main/src/js/00-storage.js) (Local storage), [`src/js/16-edit-tools.js`](https://github.com/smailmelki/melkicad/blob/main/src/js/16-edit-tools.js) (Edit operations), [`android-wrapper/android-bridge.js`](https://github.com/smailmelki/melkicad/blob/main/android-wrapper/android-bridge.js) (Android bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Plan editing"]
  node_toolbar["Tool controls<br/>[22-toolbar.js]"]
  node_keyboard["Keyboard shortcuts<br/>[20-keyboard.js]"]
  node_pointer["Pointer input<br/>[14-pointer.js]"]
  node_draw["Drawing tools<br/>[13-draw-input.js]"]
  node_geometry["Geometry<br/>[02-geometry.js]"]
  node_snap["Point snapping<br/>[03-snap.js]"]
  node_selection["Selection<br/>[04-selection.js]"]
  node_edit["Edit operations<br/>[16-edit-tools.js]"]
  node_dimensions["Dimensions<br/>[10-dimensions.js]"]
  node_furniture["Furniture<br/>[11-furniture.js]"]
  node_openings["Doors and openings<br/>[12-openings.js]"]
  node_areas["Area calculations<br/>[19-areas.js]"]
  node_render["Canvas rendering<br/>[09-render.js]"]
end

subgraph group_projects["Projects and data"]
  node_projects_ui["Project management<br/>[07-projects.js]"]
  node_layers["Layer management<br/>[06-layers.js]"]
  node_persistence["Save and undo<br/>[05-persistence.js]"]
  node_store[("Local storage<br/>[00-storage.js]")]
  node_settings["App settings<br/>[21-settings.js]"]
end

subgraph group_output["Import and output"]
  node_project_io["Project JSON I/O<br/>[08-project-io.js]"]
  node_dxf["DXF import/export<br/>[17-dxf.js]"]
  node_print["Print layout<br/>[18-print.js]"]
  node_pdf["PDF generation<br/>[18a-pdf.js]"]
end

subgraph group_platform["App platform"]
  node_app["App startup<br/>[23-main.js]"]
  node_service_worker["Offline cache<br/>[sw.js]"]
  node_android_bridge["Android bridge<br/>[android-bridge.js]"]
  node_activity["Capacitor activity<br/>[MainActivity.java]"]
  node_save_plugin["Android file saving"]
  node_print_plugin["Android printing"]
end

node_user(("Plan editor"))
node_browser(("Browser runtime"))

node_user -->|"chooses tools"| node_toolbar
node_user -->|"draws on canvas"| node_pointer
node_user -->|"uses shortcuts"| node_keyboard
node_toolbar -.->|"selects tools"| node_draw
node_pointer -.->|"provides input"| node_draw
node_draw -.->|"snaps points"| node_snap
node_draw -.->|"creates geometry"| node_geometry
node_selection -.->|"edits selection"| node_edit
node_edit -.->|"uses geometry"| node_geometry
node_draw -->|"requests redraw"| node_render
node_edit -.->|"redraws changes"| node_render
node_app -->|"initializes before use"| node_store
node_projects_ui -.->|"stores projects"| node_store
node_persistence -->|"reads and writes"| node_store
node_layers -.->|"persists layer data"| node_store
node_settings -.->|"stores office data"| node_store
node_user -->|"manages projects"| node_projects_ui
node_user -->|"imports or exports JSON"| node_project_io
node_user -->|"imports or exports DXF"| node_dxf
node_user -->|"configures print"| node_print
node_print -.->|"generates PDF"| node_pdf
node_browser -->|"runs app"| node_app
node_browser -->|"uses offline cache"| node_service_worker
node_android_bridge -->|"calls save"| node_save_plugin
node_android_bridge -->|"calls print"| node_print_plugin
node_activity -->|"registers plugin"| node_save_plugin
node_activity -->|"registers plugin"| node_print_plugin

click node_app "https://github.com/smailmelki/melkicad/blob/main/src/js/23-main.js"
click node_toolbar "https://github.com/smailmelki/melkicad/blob/main/src/js/22-toolbar.js"
click node_keyboard "https://github.com/smailmelki/melkicad/blob/main/src/js/20-keyboard.js"
click node_pointer "https://github.com/smailmelki/melkicad/blob/main/src/js/14-pointer.js"
click node_draw "https://github.com/smailmelki/melkicad/blob/main/src/js/13-draw-input.js"
click node_geometry "https://github.com/smailmelki/melkicad/blob/main/src/js/02-geometry.js"
click node_snap "https://github.com/smailmelki/melkicad/blob/main/src/js/03-snap.js"
click node_selection "https://github.com/smailmelki/melkicad/blob/main/src/js/04-selection.js"
click node_edit "https://github.com/smailmelki/melkicad/blob/main/src/js/16-edit-tools.js"
click node_dimensions "https://github.com/smailmelki/melkicad/blob/main/src/js/10-dimensions.js"
click node_furniture "https://github.com/smailmelki/melkicad/blob/main/src/js/11-furniture.js"
click node_openings "https://github.com/smailmelki/melkicad/blob/main/src/js/12-openings.js"
click node_areas "https://github.com/smailmelki/melkicad/blob/main/src/js/19-areas.js"
click node_render "https://github.com/smailmelki/melkicad/blob/main/src/js/09-render.js"
click node_projects_ui "https://github.com/smailmelki/melkicad/blob/main/src/js/07-projects.js"
click node_layers "https://github.com/smailmelki/melkicad/blob/main/src/js/06-layers.js"
click node_persistence "https://github.com/smailmelki/melkicad/blob/main/src/js/05-persistence.js"
click node_store "https://github.com/smailmelki/melkicad/blob/main/src/js/00-storage.js"
click node_settings "https://github.com/smailmelki/melkicad/blob/main/src/js/21-settings.js"
click node_project_io "https://github.com/smailmelki/melkicad/blob/main/src/js/08-project-io.js"
click node_dxf "https://github.com/smailmelki/melkicad/blob/main/src/js/17-dxf.js"
click node_print "https://github.com/smailmelki/melkicad/blob/main/src/js/18-print.js"
click node_pdf "https://github.com/smailmelki/melkicad/blob/main/src/js/18a-pdf.js"
click node_service_worker "https://github.com/smailmelki/melkicad/blob/main/src/sw.js"
click node_android_bridge "https://github.com/smailmelki/melkicad/blob/main/android-wrapper/android-bridge.js"
click node_activity "https://github.com/smailmelki/melkicad/blob/main/android-wrapper/native/android/MainActivity.java"
click node_save_plugin "https://github.com/smailmelki/melkicad/blob/main/android-wrapper/native/android/SaveFilePlugin.java"
click node_print_plugin "https://github.com/smailmelki/melkicad/blob/main/android-wrapper/native/android/PrintPdfPlugin.java"

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_toolbar,node_keyboard,node_pointer,node_draw,node_geometry,node_snap,node_selection,node_edit,node_dimensions,node_furniture,node_openings,node_areas,node_render,node_browser toneBlue
class node_projects_ui,node_layers,node_persistence,node_store,node_settings toneAmber
class node_project_io,node_dxf,node_print,node_pdf toneMint
class node_app,node_service_worker,node_android_bridge,node_activity,node_save_plugin,node_print_plugin toneRose
class node_user toneIndigo
```

## Components

### Plan editing

- [Tool controls](https://github.com/smailmelki/melkicad/blob/main/src/js/22-toolbar.js): `src/js/22-toolbar.js`
- [Keyboard shortcuts](https://github.com/smailmelki/melkicad/blob/main/src/js/20-keyboard.js): `src/js/20-keyboard.js`
- [Pointer input](https://github.com/smailmelki/melkicad/blob/main/src/js/14-pointer.js): `src/js/14-pointer.js`
- [Drawing tools](https://github.com/smailmelki/melkicad/blob/main/src/js/13-draw-input.js): `src/js/13-draw-input.js`
- [Geometry](https://github.com/smailmelki/melkicad/blob/main/src/js/02-geometry.js): `src/js/02-geometry.js`
- [Point snapping](https://github.com/smailmelki/melkicad/blob/main/src/js/03-snap.js): `src/js/03-snap.js`
- [Selection](https://github.com/smailmelki/melkicad/blob/main/src/js/04-selection.js): `src/js/04-selection.js`
- [Edit operations](https://github.com/smailmelki/melkicad/blob/main/src/js/16-edit-tools.js): `src/js/16-edit-tools.js`
- [Dimensions](https://github.com/smailmelki/melkicad/blob/main/src/js/10-dimensions.js): `src/js/10-dimensions.js`
- [Furniture](https://github.com/smailmelki/melkicad/blob/main/src/js/11-furniture.js): `src/js/11-furniture.js`
- [Doors and openings](https://github.com/smailmelki/melkicad/blob/main/src/js/12-openings.js): `src/js/12-openings.js`
- [Area calculations](https://github.com/smailmelki/melkicad/blob/main/src/js/19-areas.js): `src/js/19-areas.js`
- [Canvas rendering](https://github.com/smailmelki/melkicad/blob/main/src/js/09-render.js): `src/js/09-render.js`

### Projects and data

- [Project management](https://github.com/smailmelki/melkicad/blob/main/src/js/07-projects.js): `src/js/07-projects.js`
- [Layer management](https://github.com/smailmelki/melkicad/blob/main/src/js/06-layers.js): `src/js/06-layers.js`
- [Save and undo](https://github.com/smailmelki/melkicad/blob/main/src/js/05-persistence.js): `src/js/05-persistence.js`
- [Local storage](https://github.com/smailmelki/melkicad/blob/main/src/js/00-storage.js): `src/js/00-storage.js`
- [App settings](https://github.com/smailmelki/melkicad/blob/main/src/js/21-settings.js): `src/js/21-settings.js`

### Import and output

- [Project JSON I/O](https://github.com/smailmelki/melkicad/blob/main/src/js/08-project-io.js): `src/js/08-project-io.js`
- [DXF import/export](https://github.com/smailmelki/melkicad/blob/main/src/js/17-dxf.js): `src/js/17-dxf.js`
- [Print layout](https://github.com/smailmelki/melkicad/blob/main/src/js/18-print.js): `src/js/18-print.js`
- [PDF generation](https://github.com/smailmelki/melkicad/blob/main/src/js/18a-pdf.js): `src/js/18a-pdf.js`

### App platform

- [App startup](https://github.com/smailmelki/melkicad/blob/main/src/js/23-main.js): `src/js/23-main.js`
- [Offline cache](https://github.com/smailmelki/melkicad/blob/main/src/sw.js): `src/sw.js`
- [Android bridge](https://github.com/smailmelki/melkicad/blob/main/android-wrapper/android-bridge.js): `android-wrapper/android-bridge.js`
- [Capacitor activity](https://github.com/smailmelki/melkicad/blob/main/android-wrapper/native/android/MainActivity.java): `android-wrapper/native/android/MainActivity.java`
- [Android file saving](https://github.com/smailmelki/melkicad/blob/main/android-wrapper/native/android/SaveFilePlugin.java): `android-wrapper/native/android/SaveFilePlugin.java`
- [Android printing](https://github.com/smailmelki/melkicad/blob/main/android-wrapper/native/android/PrintPdfPlugin.java): `android-wrapper/native/android/PrintPdfPlugin.java`

### Other components

- **Plan editor**
- **Browser runtime**

## Connections

- Plan editor → Tool controls: chooses tools (evidence: `README.md`)
- Plan editor → Pointer input: draws on canvas (evidence: `README.md`)
- Plan editor → Keyboard shortcuts: uses shortcuts (evidence: `README.md`)
- Tool controls → Drawing tools: selects tools
- Pointer input → Drawing tools: provides input
- Drawing tools → Point snapping: snaps points
- Drawing tools → Geometry: creates geometry
- Selection → Edit operations: edits selection
- Edit operations → Geometry: uses geometry
- Drawing tools → Canvas rendering: requests redraw (evidence: `README.md`)
- Edit operations → Canvas rendering: redraws changes
- App startup → Local storage: initializes before use (evidence: `README.md`)
- Project management → Local storage: stores projects
- Save and undo → Local storage: reads and writes (evidence: `README.md`)
- Layer management → Local storage: persists layer data
- App settings → Local storage: stores office data
- Plan editor → Project management: manages projects (evidence: `README.md`)
- Plan editor → Project JSON I/O: imports or exports JSON (evidence: `README.md`)
- Plan editor → DXF import/export: imports or exports DXF (evidence: `README.md`)
- Plan editor → Print layout: configures print (evidence: `README.md`)
- Print layout → PDF generation: generates PDF
- Browser runtime → App startup: runs app (evidence: `README.md`)
- Browser runtime → Offline cache: uses offline cache (evidence: `src/sw.js`)
- Android bridge → Android file saving: calls save (evidence: `android-wrapper/android-bridge.js`)
- Android bridge → Android printing: calls print (evidence: `android-wrapper/android-bridge.js`)
- Capacitor activity → Android file saving: registers plugin (evidence: `android-wrapper/native/android/MainActivity.java`)
- Capacitor activity → Android printing: registers plugin (evidence: `android-wrapper/native/android/MainActivity.java`)
