# parthjadhav/tkinter-designer architecture

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

- Interactive diagram: https://gitdiagram.com/parthjadhav/tkinter-designer
- Repository: https://github.com/parthjadhav/tkinter-designer

## Overview

Tkinter Designer turns a Figma file or selected frame into runnable Tkinter code and image assets. Users can initiate generation through the CLI or desktop GUI; both lead into design orchestration, Figma retrieval, frame and element conversion, then template rendering and output. The README also documents script, class, and multi-page outputs with optional themes. The graph follows documented behavior and excerpted/indexed references; some internal calls are supported by the SOURCE INDEX rather than full method excerpts.

Main entry points: [`tkdesigner/figma/frame.py`](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/frame.py) (Frame conversion), [`tkdesigner/designer.py`](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/designer.py) (Design orchestrator), [`tkdesigner/cli.py`](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/cli.py) (CLI), [`gui/gui.py`](https://github.com/parthjadhav/tkinter-designer/blob/master/gui/gui.py) (Desktop GUI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_cli["CLI<br/>[cli.py]"]
  node_desktop["Desktop GUI<br/>[gui.py]"]
end

subgraph group_orchestration["Generation orchestration"]
  node_url["URL parsing<br/>[utils.py]"]
  node_designer["Design orchestrator<br/>[designer.py]"]
end

subgraph group_figma["Figma interpretation"]
  node_figma_api["Figma API client<br/>[endpoints.py]"]
  node_frame["Frame conversion<br/>[frame.py]"]
  node_node["Figma node model<br/>[node.py]"]
  node_vectors["Vector elements<br/>[vector_elements.py]"]
  node_widgets["Custom widgets<br/>[custom_elements.py]"]
  node_image_utils["Image and color utilities<br/>[utils.py]"]
end

subgraph group_output["Generated application"]
  node_templates["Code templates<br/>[template.py]"]
  node_assets["Generated image assets<br/>[frame.py]"]
  node_generated_app["Tkinter application"]
end

node_user(("Designer user"))
node_figma_service["Figma service"]
node_filesystem["Output directory"]

node_user -->|"runs"| node_cli
node_user -->|"enters details"| node_desktop
node_cli -->|"parses URL"| node_url
node_cli -->|"starts generation"| node_designer
node_desktop -->|"validates URL"| node_url
node_desktop -->|"starts generation"| node_designer
node_designer -->|"fetches file"| node_figma_api
node_figma_api -->|"requests file and images"| node_figma_service
node_designer -->|"converts frames"| node_frame
node_frame -->|"exports images"| node_figma_api
node_frame -->|"models frame nodes"| node_node
node_frame -->|"creates vector elements"| node_vectors
node_frame -->|"creates widgets"| node_widgets
node_vectors -->|"extends node model"| node_node
node_widgets -->|"extends vector elements"| node_vectors
node_frame -->|"downloads and formats assets"| node_image_utils
node_widgets -->|"formats text and colors"| node_image_utils
node_designer -->|"renders template"| node_templates
node_frame -->|"provides element code"| node_templates
node_designer -->|"writes generated code"| node_filesystem
node_frame -->|"writes image assets"| node_assets
node_assets -->|"saved under output"| node_filesystem
node_templates -->|"defines app output"| node_generated_app
node_generated_app -->|"runs from generated files"| node_filesystem

click node_cli "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/cli.py"
click node_desktop "https://github.com/parthjadhav/tkinter-designer/blob/master/gui/gui.py"
click node_url "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/utils.py"
click node_designer "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/designer.py"
click node_figma_api "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/endpoints.py"
click node_frame "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/frame.py"
click node_node "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/node.py"
click node_vectors "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/vector_elements.py"
click node_widgets "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/custom_elements.py"
click node_image_utils "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/utils.py"
click node_templates "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/template.py"
click node_assets "https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/frame.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_cli,node_desktop,node_user toneBlue
class node_url,node_designer toneAmber
class node_figma_api,node_frame,node_node,node_vectors,node_widgets,node_image_utils toneMint
class node_templates,node_assets,node_generated_app toneRose
class node_figma_service,node_filesystem toneIndigo
```

## Components

### User entry points

- [CLI](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/cli.py): `tkdesigner/cli.py`
- [Desktop GUI](https://github.com/parthjadhav/tkinter-designer/blob/master/gui/gui.py): `gui/gui.py`

### Generation orchestration

- [URL parsing](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/utils.py): `tkdesigner/utils.py`
- [Design orchestrator](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/designer.py): `tkdesigner/designer.py`

### Figma interpretation

- [Figma API client](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/endpoints.py): `tkdesigner/figma/endpoints.py`
- [Frame conversion](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/frame.py): `tkdesigner/figma/frame.py`
- [Figma node model](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/node.py): `tkdesigner/figma/node.py`
- [Vector elements](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/vector_elements.py): `tkdesigner/figma/vector_elements.py`
- [Custom widgets](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/custom_elements.py): `tkdesigner/figma/custom_elements.py`
- [Image and color utilities](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/utils.py): `tkdesigner/utils.py`

### Generated application

- [Code templates](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/template.py): `tkdesigner/template.py`
- [Generated image assets](https://github.com/parthjadhav/tkinter-designer/blob/master/tkdesigner/figma/frame.py): `tkdesigner/figma/frame.py`
- **Tkinter application**

### Other components

- **Designer user**
- **Figma service**
- **Output directory**

## Connections

- Designer user → CLI: runs (evidence: `README.md`)
- Designer user → Desktop GUI: enters details (evidence: `gui/gui.py`)
- CLI → URL parsing: parses URL (evidence: `tkdesigner/cli.py`)
- CLI → Design orchestrator: starts generation (evidence: `tkdesigner/cli.py`)
- Desktop GUI → URL parsing: validates URL (evidence: `gui/gui.py`)
- Desktop GUI → Design orchestrator: starts generation (evidence: `gui/gui.py`)
- Design orchestrator → Figma API client: fetches file (evidence: `tkdesigner/designer.py`)
- Figma API client → Figma service: requests file and images (evidence: `tkdesigner/figma/endpoints.py`)
- Design orchestrator → Frame conversion: converts frames (evidence: `tkdesigner/designer.py`)
- Frame conversion → Figma API client: exports images (evidence: `tkdesigner/figma/frame.py`)
- Frame conversion → Figma node model: models frame nodes (evidence: `tkdesigner/figma/frame.py`)
- Frame conversion → Vector elements: creates vector elements (evidence: `tkdesigner/figma/frame.py`)
- Frame conversion → Custom widgets: creates widgets (evidence: `tkdesigner/figma/frame.py`)
- Vector elements → Figma node model: extends node model (evidence: `tkdesigner/figma/vector_elements.py`)
- Custom widgets → Vector elements: extends vector elements (evidence: `tkdesigner/figma/custom_elements.py`)
- Frame conversion → Image and color utilities: downloads and formats assets (evidence: `tkdesigner/figma/frame.py`)
- Custom widgets → Image and color utilities: formats text and colors (evidence: `tkdesigner/figma/custom_elements.py`)
- Design orchestrator → Code templates: renders template (evidence: `tkdesigner/designer.py`)
- Frame conversion → Code templates: provides element code (evidence: `tkdesigner/designer.py`)
- Design orchestrator → Output directory: writes generated code (evidence: `tkdesigner/designer.py`)
- Frame conversion → Generated image assets: writes image assets (evidence: `tkdesigner/figma/frame.py`)
- Generated image assets → Output directory: saved under output (evidence: `tkdesigner/figma/frame.py`)
- Code templates → Tkinter application: defines app output (evidence: `README.md`)
- Tkinter application → Output directory: runs from generated files (evidence: `README.md`)
