# xdarkstar56x/framelab architecture

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

- Interactive diagram: https://gitdiagram.com/xdarkstar56x/framelab
- Repository: https://github.com/xdarkstar56x/framelab

## Overview

FrameLab es una aplicación web local para convertir una fotografía en una presentación editorial exportable. El flujo principal va desde la selección de imagen y la lectura de EXIF hasta el ajuste de recorte, la vista previa y la descarga; también ofrece presets, paleta de color y controles tipográficos y visuales. La coordinación de interfaz, metadatos, recorte y exportación está concentrada en app.js, mientras canvas-engine.js dibuja el marco. Las conexiones se limitan a las llamadas visibles y las capacidades documentadas.

Main entry points: [`app.js`](https://github.com/xdarkstar56x/framelab/blob/main/app.js) (Control de aplicación), [`canvas-engine.js`](https://github.com/xdarkstar56x/framelab/blob/main/canvas-engine.js) (Renderizado de marco), [`index.html`](https://github.com/xdarkstar56x/framelab/blob/main/index.html) (Interfaz web), [`presets.js`](https://github.com/xdarkstar56x/framelab/blob/main/presets.js) (Estilos base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Flujo fotográfico"]
  node_interface["Interfaz web<br/>[index.html]"]
  node_controller["Control de aplicación<br/>[app.js]"]
  node_exif["Lectura EXIF<br/>[app.js]"]
  node_metadata_lib["exifr"]
  node_cropping["Recorte de imagen<br/>[app.js]"]
end

subgraph group_design["Diseño del marco"]
  node_palette["Paleta de color<br/>[app.js]"]
  node_color_thief["ColorThief"]
  node_presets["Estilos base<br/>[presets.js]"]
end

subgraph group_output["Vista y exportación"]
  node_frame_render["Renderizado de marco<br/>[canvas-engine.js]"]
  node_preview["Vista previa<br/>[app.js]"]
  node_export["Exportación JPEG/PNG<br/>[app.js]"]
end

node_photographer(("Fotógrafo"))
node_browser["Navegador"]

node_photographer -->|"selecciona imagen"| node_interface
node_controller -->|"lee controles"| node_interface
node_controller -->|"lee EXIF"| node_metadata_lib
node_metadata_lib -->|"devuelve metadatos"| node_exif
node_controller -->|"extrae paleta"| node_color_thief
node_color_thief -->|"devuelve colores"| node_palette
node_controller -->|"aplica preset"| node_presets
node_controller -->|"prepara recorte"| node_cropping
node_controller -->|"solicita renderizado"| node_frame_render
node_frame_render -->|"dibuja vista"| node_preview
node_controller -->|"configura descarga"| node_export
node_export -->|"recorta imagen"| node_cropping
node_export -->|"renderiza salida"| node_frame_render
node_export -->|"descarga archivo"| node_browser

click node_interface "https://github.com/xdarkstar56x/framelab/blob/main/index.html"
click node_controller "https://github.com/xdarkstar56x/framelab/blob/main/app.js"
click node_exif "https://github.com/xdarkstar56x/framelab/blob/main/app.js"
click node_cropping "https://github.com/xdarkstar56x/framelab/blob/main/app.js"
click node_palette "https://github.com/xdarkstar56x/framelab/blob/main/app.js"
click node_presets "https://github.com/xdarkstar56x/framelab/blob/main/presets.js"
click node_frame_render "https://github.com/xdarkstar56x/framelab/blob/main/canvas-engine.js"
click node_preview "https://github.com/xdarkstar56x/framelab/blob/main/app.js"
click node_export "https://github.com/xdarkstar56x/framelab/blob/main/app.js"

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_interface,node_controller,node_exif,node_metadata_lib,node_cropping toneBlue
class node_palette,node_color_thief,node_presets toneAmber
class node_frame_render,node_preview,node_export toneMint
class node_photographer,node_browser toneIndigo
```

## Components

### Flujo fotográfico

- [Interfaz web](https://github.com/xdarkstar56x/framelab/blob/main/index.html): `index.html`
- [Control de aplicación](https://github.com/xdarkstar56x/framelab/blob/main/app.js): `app.js`
- [Lectura EXIF](https://github.com/xdarkstar56x/framelab/blob/main/app.js): `app.js`
- **exifr**
- [Recorte de imagen](https://github.com/xdarkstar56x/framelab/blob/main/app.js): `app.js`

### Diseño del marco

- [Paleta de color](https://github.com/xdarkstar56x/framelab/blob/main/app.js): `app.js`
- **ColorThief**
- [Estilos base](https://github.com/xdarkstar56x/framelab/blob/main/presets.js): `presets.js`

### Vista y exportación

- [Renderizado de marco](https://github.com/xdarkstar56x/framelab/blob/main/canvas-engine.js): `canvas-engine.js`
- [Vista previa](https://github.com/xdarkstar56x/framelab/blob/main/app.js): `app.js`
- [Exportación JPEG/PNG](https://github.com/xdarkstar56x/framelab/blob/main/app.js): `app.js`

### Other components

- **Fotógrafo**
- **Navegador**

## Connections

- Fotógrafo → Interfaz web: selecciona imagen (evidence: `readme.md`)
- Control de aplicación → Interfaz web: lee controles (evidence: `app.js`)
- Control de aplicación → exifr: lee EXIF (evidence: `app.js`)
- exifr → Lectura EXIF: devuelve metadatos (evidence: `app.js`)
- Control de aplicación → ColorThief: extrae paleta (evidence: `app.js`)
- ColorThief → Paleta de color: devuelve colores (evidence: `app.js`)
- Control de aplicación → Estilos base: aplica preset (evidence: `app.js`)
- Control de aplicación → Recorte de imagen: prepara recorte (evidence: `app.js`)
- Control de aplicación → Renderizado de marco: solicita renderizado (evidence: `app.js`)
- Renderizado de marco → Vista previa: dibuja vista (evidence: `app.js`)
- Control de aplicación → Exportación JPEG/PNG: configura descarga (evidence: `app.js`)
- Exportación JPEG/PNG → Recorte de imagen: recorta imagen (evidence: `app.js`)
- Exportación JPEG/PNG → Renderizado de marco: renderiza salida (evidence: `app.js`)
- Exportación JPEG/PNG → Navegador: descarga archivo (evidence: `app.js`)
