# tsiger/widgetizer architecture

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

- Interactive diagram: https://gitdiagram.com/tsiger/widgetizer
- Repository: https://github.com/tsiger/widgetizer

## Overview

Widgetizer is a visual website builder whose main workflow is project setup, content and theme editing, live preview, then static export. Its web editor and API are separate workspace packages; project metadata is stored in SQLite while portable site content and uploads live on disk. The graph includes the documented multilingual, collections, media, SEO, presets, and desktop capabilities. Some backend and UI subsystems are represented at directory level because their individual implementations were not sampled; links without direct evidence are omitted.

Main entry points: [`packages/builder-server/src/controllers/exportController.js`](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/exportController.js) (Static export), [`packages/editor-ui/src/EditorShell.jsx`](https://github.com/tsiger/widgetizer/blob/master/packages/editor-ui/src/EditorShell.jsx) (Editor workspace), [`packages/builder-server/src/createApp.js`](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/createApp.js) (Builder API), [`packages/builder-server/src/controllers/previewController.js`](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/previewController.js) (Preview controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shells"]
  node_webapp["Web app shell<br/>[App.jsx]"]
  node_desktop["Desktop shell<br/>[main.js]"]
end

subgraph group_authoring["Site authoring"]
  node_editor["Editor workspace<br/>[EditorShell.jsx]"]
  node_pageedit["Page and widget editor<br/>[PageEditor.jsx]"]
  node_projectedit["Project setup<br/>[ProjectsAdd.jsx]"]
  node_theme["Themes and presets<br/>[themeController.js]"]
  node_languages["Multilingual content<br/>[contentLanguage.js]"]
  node_previewui["Preview client<br/>[previewManager.js]"]
  node_previewroutes["Preview routes<br/>[previewRoutes.jsx]"]
end

subgraph group_backend["Builder API"]
  node_collections["Collections"]
  node_media["Media pipeline"]
  node_api["Builder API<br/>[createApp.js]"]
  node_previewapi["Preview controller"]
end

subgraph group_runtime["Render and export"]
  node_rendering["Rendering service"]
  node_engine["Render engine<br/>[renderEngine.js]"]
  node_export["Static export"]
  node_seo["SEO artifacts<br/>[seoArtifacts.js]"]
end

subgraph group_storage["Persistence"]
  node_projectdb[("Project metadata")]
  node_mediadb[("Media metadata<br/>[mediaRepository.js]")]
  node_localstorage["Local storage adapters"]
end

node_author(("Site creator"))

node_author -->|"opens"| node_webapp
node_author -->|"runs"| node_desktop
node_webapp -->|"mounts"| node_editor
node_editor -->|"edits pages"| node_pageedit
node_author -->|"creates project"| node_projectedit
node_author -->|"chooses design"| node_theme
node_author -->|"writes translations"| node_languages
node_author -->|"manages items"| node_collections
node_author -->|"uploads assets"| node_media
node_editor -->|"uses API"| node_api
node_previewui -->|"requests preview"| node_previewapi
node_previewroutes -.->|"hosts preview"| node_previewui
node_previewapi -->|"renders content"| node_rendering
node_previewapi -->|"loads items"| node_collections
node_rendering -.->|"uses engine"| node_engine
node_author -->|"exports site"| node_export
node_export -->|"renders pages"| node_rendering
node_export -->|"builds SEO"| node_seo
node_api -->|"stores metadata"| node_projectdb
node_media -->|"records usage"| node_mediadb
node_api -->|"stores content"| node_localstorage
node_export -.->|"reads site files"| node_localstorage

click node_webapp "https://github.com/tsiger/widgetizer/blob/master/app/src/App.jsx"
click node_desktop "https://github.com/tsiger/widgetizer/blob/master/electron/main.js"
click node_editor "https://github.com/tsiger/widgetizer/blob/master/packages/editor-ui/src/EditorShell.jsx"
click node_pageedit "https://github.com/tsiger/widgetizer/blob/master/packages/editor-ui/src/pages/PageEditor.jsx"
click node_projectedit "https://github.com/tsiger/widgetizer/blob/master/app/src/pages/ProjectsAdd.jsx"
click node_theme "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/themeController.js"
click node_languages "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/utils/contentLanguage.js"
click node_collections "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/collectionService.js"
click node_media "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/mediaUsageService.js"
click node_api "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/createApp.js"
click node_previewui "https://github.com/tsiger/widgetizer/blob/master/packages/editor-ui/src/queries/previewManager.js"
click node_previewroutes "https://github.com/tsiger/widgetizer/blob/master/app/src/previewRoutes.jsx"
click node_previewapi "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/previewController.js"
click node_rendering "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/renderingService.js"
click node_engine "https://github.com/tsiger/widgetizer/blob/master/packages/render-engine/src/renderEngine.js"
click node_export "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/exportController.js"
click node_seo "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/seoArtifacts.js"
click node_projectdb "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/db/repositories/projectRepository.js"
click node_mediadb "https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/db/repositories/mediaRepository.js"
click node_localstorage "https://github.com/tsiger/widgetizer/blob/master/packages/adapters-local/src/LocalStorageAdapter.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_webapp,node_desktop toneBlue
class node_editor,node_pageedit,node_projectedit,node_theme,node_languages,node_previewui,node_previewroutes toneAmber
class node_collections,node_media,node_api,node_previewapi toneMint
class node_rendering,node_engine,node_export,node_seo toneRose
class node_projectdb,node_mediadb,node_localstorage,node_author toneIndigo
```

## Components

### App shells

- [Web app shell](https://github.com/tsiger/widgetizer/blob/master/app/src/App.jsx): `app/src/App.jsx`
- [Desktop shell](https://github.com/tsiger/widgetizer/blob/master/electron/main.js): `electron/main.js`

### Site authoring

- [Editor workspace](https://github.com/tsiger/widgetizer/blob/master/packages/editor-ui/src/EditorShell.jsx): `packages/editor-ui/src/EditorShell.jsx`
- [Page and widget editor](https://github.com/tsiger/widgetizer/blob/master/packages/editor-ui/src/pages/PageEditor.jsx): `packages/editor-ui/src/pages/PageEditor.jsx`
- [Project setup](https://github.com/tsiger/widgetizer/blob/master/app/src/pages/ProjectsAdd.jsx): `app/src/pages/ProjectsAdd.jsx`
- [Themes and presets](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/themeController.js): `packages/builder-server/src/controllers/themeController.js`
- [Multilingual content](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/utils/contentLanguage.js): `packages/builder-server/src/utils/contentLanguage.js`
- [Preview client](https://github.com/tsiger/widgetizer/blob/master/packages/editor-ui/src/queries/previewManager.js): `packages/editor-ui/src/queries/previewManager.js`
- [Preview routes](https://github.com/tsiger/widgetizer/blob/master/app/src/previewRoutes.jsx): `app/src/previewRoutes.jsx`

### Builder API

- [Collections](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/collectionService.js): `packages/builder-server/src/services/collectionService.js`
- [Media pipeline](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/mediaUsageService.js): `packages/builder-server/src/services/mediaUsageService.js`
- [Builder API](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/createApp.js): `packages/builder-server/src/createApp.js`
- [Preview controller](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/previewController.js): `packages/builder-server/src/controllers/previewController.js`

### Render and export

- [Rendering service](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/renderingService.js): `packages/builder-server/src/services/renderingService.js`
- [Render engine](https://github.com/tsiger/widgetizer/blob/master/packages/render-engine/src/renderEngine.js): `packages/render-engine/src/renderEngine.js`
- [Static export](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/controllers/exportController.js): `packages/builder-server/src/controllers/exportController.js`
- [SEO artifacts](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/services/seoArtifacts.js): `packages/builder-server/src/services/seoArtifacts.js`

### Persistence

- [Project metadata](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/db/repositories/projectRepository.js): `packages/builder-server/src/db/repositories/projectRepository.js`
- [Media metadata](https://github.com/tsiger/widgetizer/blob/master/packages/builder-server/src/db/repositories/mediaRepository.js): `packages/builder-server/src/db/repositories/mediaRepository.js`
- [Local storage adapters](https://github.com/tsiger/widgetizer/blob/master/packages/adapters-local/src/LocalStorageAdapter.js): `packages/adapters-local/src/LocalStorageAdapter.js`

### Other components

- **Site creator**

## Connections

- Site creator → Web app shell: opens
- Site creator → Desktop shell: runs
- Web app shell → Editor workspace: mounts (evidence: `app/src/App.jsx`)
- Editor workspace → Page and widget editor: edits pages
- Site creator → Project setup: creates project
- Site creator → Themes and presets: chooses design
- Site creator → Multilingual content: writes translations
- Site creator → Collections: manages items
- Site creator → Media pipeline: uploads assets
- Editor workspace → Builder API: uses API
- Preview client → Preview controller: requests preview (evidence: `packages/editor-ui/src/queries/previewManager.js`)
- Preview routes → Preview client: hosts preview
- Preview controller → Rendering service: renders content (evidence: `packages/builder-server/src/controllers/previewController.js`)
- Preview controller → Collections: loads items (evidence: `packages/builder-server/src/controllers/previewController.js`)
- Rendering service → Render engine: uses engine
- Site creator → Static export: exports site
- Static export → Rendering service: renders pages (evidence: `packages/builder-server/src/controllers/exportController.js`)
- Static export → SEO artifacts: builds SEO (evidence: `packages/builder-server/src/controllers/exportController.js`)
- Builder API → Project metadata: stores metadata
- Media pipeline → Media metadata: records usage (evidence: `packages/builder-server/src/services/mediaUsageService.js`)
- Builder API → Local storage adapters: stores content
- Static export → Local storage adapters: reads site files
