# nucleonautomation/gluonix-designer architecture

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

- Interactive diagram: https://gitdiagram.com/nucleonautomation/gluonix-designer
- Repository: https://github.com/nucleonautomation/gluonix-designer

## Overview

Gluonix Designer is a drag-and-drop GUI design tool for Python applications. The main workflow starts in the desktop app, opens or creates a project, edits a design using a component palette, element tree, and property configurators, then previews or exports the resulting interface. Its Gluonix runtime supplies widgets, canvas drawing and editing, image/video support, and animation capabilities. The source index and excerpts support the app-to-view and runtime relationships; export and some project/design wiring are documented but not visible in sampled code, so those links are marked unverified.

Main entry points: [`Designer/Nucleon/Gluonix`](https://github.com/nucleonautomation/gluonix-designer/tree/main/Designer/Nucleon/Gluonix) (GUI Widgets), [`Designer/Program/View/N_Design.py`](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/N_Design.py) (Design View), [`Designer/Nucleon/Gluonix/N_Canvas.py`](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Canvas.py) (Canvas Shapes), [`Designer/Program/View/Home/N_Panel_Overview.py`](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Home/N_Panel_Overview.py) (Home and Overview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["App Entry<br/>[Designer.py]"]
  node_main["Main Window<br/>[Designer.py]"]
end

subgraph group_projects["Projects"]
  node_home["Home and Overview"]
  node_project["Project Setup<br/>[N_Project.py]"]
  node_compare["Project Compare<br/>[N_Compare.py]"]
  node_projectdb[("Project Data<br/>[N_Project.py]")]
end

subgraph group_design["Design Workspace"]
  node_designview["Design View<br/>[N_Design.py]"]
  node_palette["Component Palette<br/>[N_Stock.py]"]
  node_elementtree["Element Tree<br/>[N_Element.py]"]
  node_config["Property Configuration"]
  node_export["Python Export"]
end

subgraph group_runtime["Gluonix Runtime"]
  node_runner["Runtime Loader<br/>[Runner.py]"]
  node_widgetlib["GUI Widgets"]
  node_gui["GUI Core<br/>[N_GUI.py]"]
  node_custom["Events and Bindings<br/>[N_Custom.py]"]
end

subgraph group_media["Media and Drawing"]
  node_canvas["Canvas Shapes<br/>[N_Canvas.py]"]
  node_editor["Canvas Editor<br/>[N_Editor.py]"]
  node_viewport["Drawing Viewport<br/>[N_Viewport.py]"]
  node_flowchart["Flowchart<br/>[N_Flowchart.py]"]
  node_image["Image Widget<br/>[N_Image.py]"]
  node_player["Media Player<br/>[N_Player.py]"]
  node_video["Video Widget<br/>[N_Video.py]"]
end

node_developer(("Developer"))

node_developer -->|"starts app"| node_entry
node_entry -->|"loads entry point"| node_main
node_main -->|"opens overview"| node_home
node_home -.->|"manages projects"| node_project
node_project -->|"updates project data"| node_projectdb
node_home -->|"opens comparison"| node_compare
node_developer -->|"designs interface"| node_designview
node_designview -->|"uses component palette"| node_palette
node_designview -->|"loads elements"| node_elementtree
node_designview -->|"opens configurators"| node_config
node_elementtree -->|"reads and updates"| node_projectdb
node_developer -.->|"requests export"| node_export
node_projectdb -->|"loads saved design"| node_runner
node_runner -->|"instantiates widgets"| node_widgetlib
node_widgetlib -->|"uses GUI core"| node_gui
node_widgetlib -->|"provides canvas"| node_canvas
node_canvas -.->|"offers editing"| node_editor
node_canvas -.->|"offers drawing"| node_viewport
node_widgetlib -->|"provides flowchart"| node_flowchart
node_widgetlib -->|"provides images"| node_image
node_widgetlib -->|"provides playback"| node_player
node_widgetlib -->|"provides video"| node_video
node_canvas -->|"binds canvas events"| node_custom
node_gui -->|"uses event bindings"| node_custom

click node_entry "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Designer.py"
click node_main "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/Main/Designer.py"
click node_home "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Home/N_Panel_Overview.py"
click node_project "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Home/N_Project.py"
click node_compare "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/N_Compare.py"
click node_designview "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/N_Design.py"
click node_palette "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Design/N_Stock.py"
click node_elementtree "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Design/N_Element.py"
click node_config "https://github.com/nucleonautomation/gluonix-designer/tree/main/Designer/Program/View/Design"
click node_projectdb "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Home/N_Project.py"
click node_export "https://github.com/nucleonautomation/gluonix-designer/tree/main/Designer/Program/View/Design"
click node_runner "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Runner.py"
click node_widgetlib "https://github.com/nucleonautomation/gluonix-designer/tree/main/Designer/Nucleon/Gluonix"
click node_gui "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_GUI.py"
click node_canvas "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Canvas.py"
click node_editor "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Editor.py"
click node_viewport "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Viewport.py"
click node_flowchart "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Flowchart.py"
click node_image "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Image.py"
click node_player "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Player.py"
click node_video "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Video.py"
click node_custom "https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Custom.py"

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_entry,node_main toneBlue
class node_home,node_project,node_compare,node_projectdb toneAmber
class node_designview,node_palette,node_elementtree,node_config,node_export toneMint
class node_runner,node_widgetlib,node_gui,node_custom toneRose
class node_canvas,node_editor,node_viewport,node_flowchart,node_image,node_player,node_video,node_developer toneIndigo
```

## Components

### Application

- [App Entry](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Designer.py): `Designer/Designer.py`
- [Main Window](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/Main/Designer.py): `Designer/Program/Main/Designer.py`

### Projects

- [Home and Overview](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Home/N_Panel_Overview.py): `Designer/Program/View/Home/N_Panel_Overview.py`
- [Project Setup](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Home/N_Project.py): `Designer/Program/View/Home/N_Project.py`
- [Project Compare](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/N_Compare.py): `Designer/Program/View/N_Compare.py`
- [Project Data](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Home/N_Project.py): `Designer/Program/View/Home/N_Project.py`

### Design Workspace

- [Design View](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/N_Design.py): `Designer/Program/View/N_Design.py`
- [Component Palette](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Design/N_Stock.py): `Designer/Program/View/Design/N_Stock.py`
- [Element Tree](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Program/View/Design/N_Element.py): `Designer/Program/View/Design/N_Element.py`
- [Property Configuration](https://github.com/nucleonautomation/gluonix-designer/tree/main/Designer/Program/View/Design): `Designer/Program/View/Design`
- [Python Export](https://github.com/nucleonautomation/gluonix-designer/tree/main/Designer/Program/View/Design): `Designer/Program/View/Design`

### Gluonix Runtime

- [Runtime Loader](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Runner.py): `Designer/Nucleon/Runner.py`
- [GUI Widgets](https://github.com/nucleonautomation/gluonix-designer/tree/main/Designer/Nucleon/Gluonix): `Designer/Nucleon/Gluonix`
- [GUI Core](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_GUI.py): `Designer/Nucleon/Gluonix/N_GUI.py`
- [Events and Bindings](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Custom.py): `Designer/Nucleon/Gluonix/N_Custom.py`

### Media and Drawing

- [Canvas Shapes](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Canvas.py): `Designer/Nucleon/Gluonix/N_Canvas.py`
- [Canvas Editor](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Editor.py): `Designer/Nucleon/Gluonix/N_Editor.py`
- [Drawing Viewport](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Viewport.py): `Designer/Nucleon/Gluonix/N_Viewport.py`
- [Flowchart](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Flowchart.py): `Designer/Nucleon/Gluonix/N_Flowchart.py`
- [Image Widget](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Image.py): `Designer/Nucleon/Gluonix/N_Image.py`
- [Media Player](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Player.py): `Designer/Nucleon/Gluonix/N_Player.py`
- [Video Widget](https://github.com/nucleonautomation/gluonix-designer/blob/main/Designer/Nucleon/Gluonix/N_Video.py): `Designer/Nucleon/Gluonix/N_Video.py`

### Other components

- **Developer**

## Connections

- Developer → App Entry: starts app
- App Entry → Main Window: loads entry point (evidence: `Designer/Designer.py`)
- Main Window → Home and Overview: opens overview (evidence: `Designer/Program/Main/Designer.py`)
- Home and Overview → Project Setup: manages projects (evidence: `Designer/Program/View/Home/N_Project.py`)
- Project Setup → Project Data: updates project data (evidence: `Designer/Program/View/Home/N_Project.py`)
- Home and Overview → Project Compare: opens comparison
- Developer → Design View: designs interface
- Design View → Component Palette: uses component palette (evidence: `Designer/Program/View/N_Design.py`)
- Design View → Element Tree: loads elements (evidence: `Designer/Program/View/N_Design.py`)
- Design View → Property Configuration: opens configurators (evidence: `Designer/Program/View/N_Design.py`)
- Element Tree → Project Data: reads and updates (evidence: `Designer/Program/View/Design/N_Element.py`)
- Developer → Python Export: requests export
- Project Data → Runtime Loader: loads saved design (evidence: `Designer/Nucleon/Runner.py`)
- Runtime Loader → GUI Widgets: instantiates widgets (evidence: `Designer/Nucleon/Runner.py`)
- GUI Widgets → GUI Core: uses GUI core (evidence: `Designer/Nucleon/Gluonix/__init__.py`)
- GUI Widgets → Canvas Shapes: provides canvas (evidence: `Designer/Nucleon/Gluonix/__init__.py`)
- Canvas Shapes → Canvas Editor: offers editing (evidence: `Designer/Nucleon/Gluonix/N_Canvas.py`)
- Canvas Shapes → Drawing Viewport: offers drawing (evidence: `Designer/Nucleon/Gluonix/N_Canvas.py`)
- GUI Widgets → Flowchart: provides flowchart (evidence: `Designer/Nucleon/Gluonix/__init__.py`)
- GUI Widgets → Image Widget: provides images (evidence: `Designer/Nucleon/Gluonix/__init__.py`)
- GUI Widgets → Media Player: provides playback (evidence: `Designer/Nucleon/Gluonix/__init__.py`)
- GUI Widgets → Video Widget: provides video (evidence: `Designer/Nucleon/Gluonix/__init__.py`)
- Canvas Shapes → Events and Bindings: binds canvas events (evidence: `Designer/Nucleon/Gluonix/N_Canvas.py`)
- GUI Core → Events and Bindings: uses event bindings (evidence: `Designer/Nucleon/Gluonix/N_GUI.py`)
