# shokydo/ysite-forger architecture

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

- Interactive diagram: https://gitdiagram.com/shokydo/ysite-forger
- Repository: https://github.com/shokydo/ysite-forger

## Overview

YSite-forger is a browser-based visual site builder with an integrated BG·LAB background editor. The main workflow is create or open a project, edit pages and blocks on the canvas, apply saved backgrounds, then export a single-page HTML file or a ZIP project. The README also documents BG·LAB layer, shape, symbol and cursor-FX editing and SVG/CSS/HTML export. Edges reflect calls visible in excerpts or explicit README statements; unsampled modules are included where their product role is documented, but unverified connections are omitted.

Main entry points: [`js/backgrounds.js`](https://github.com/shokydo/ysite-forger/blob/main/js/backgrounds.js) (Saved backgrounds), [`js/home.js`](https://github.com/shokydo/ysite-forger/blob/main/js/home.js) (Home workflow), [`js/app.js`](https://github.com/shokydo/ysite-forger/blob/main/js/app.js) (Editor controller), [`js/store.js`](https://github.com/shokydo/ysite-forger/blob/main/js/store.js) (Site state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_home["Project home"]
  node_home_ui["Home workflow<br/>[home.js]"]
  node_project_library["Project library<br/>[projects.js]"]
  node_dialogs["Prompts<br/>[dialogs.js]"]
end

subgraph group_editor["Site editor"]
  node_editor_controller["Editor controller<br/>[app.js]"]
  node_pages["Page manager<br/>[pages.js]"]
  node_block_library["Block library<br/>[blocks.js]"]
  node_drag_drop["Canvas drag-drop<br/>[dragdrop.js]"]
  node_settings_panel["Block settings<br/>[panel.js]"]
  node_renderer["Canvas renderer<br/>[renderer.js]"]
end

subgraph group_backgrounds["BG·LAB"]
  node_background_ui["Background editor UI<br/>[bglab-ui.js]"]
  node_background_engine["SVG and FX engine<br/>[bglab-core.js]"]
  node_saved_backgrounds[("Saved backgrounds<br/>[backgrounds.js]")]
  node_background_css_export["CSS export"]
end

subgraph group_persistence["Browser storage"]
  node_site_state[("Site state<br/>[store.js]")]
  node_local_storage[("Browser localStorage")]
end

subgraph group_output["Export"]
  node_export_controller["Site export<br/>[export.js]"]
  node_html_zip["HTML or ZIP"]
end

node_user(("Site creator"))

node_user -->|"creates or opens"| node_home_ui
node_home_ui -->|"manages projects"| node_project_library
node_home_ui -->|"prompts"| node_dialogs
node_home_ui -->|"renders preview"| node_renderer
node_home_ui -.->|"opens editor"| node_editor_controller
node_user -->|"edits site"| node_editor_controller
node_editor_controller -->|"reads and updates"| node_site_state
node_editor_controller -->|"renders canvas"| node_renderer
node_editor_controller -->|"loads page background"| node_saved_backgrounds
node_pages -->|"manages pages"| node_site_state
node_drag_drop -->|"adds and moves blocks"| node_site_state
node_block_library -.->|"provides block types"| node_drag_drop
node_settings_panel -->|"updates block"| node_site_state
node_settings_panel -->|"loads thumbnails"| node_saved_backgrounds
node_renderer -->|"embeds backgrounds"| node_saved_backgrounds
node_project_library -.->|"persists projects"| node_local_storage
node_saved_backgrounds -->|"persists backgrounds"| node_local_storage
node_user -->|"edits backgrounds"| node_background_ui
node_background_ui -.->|"builds background artwork"| node_background_engine
node_background_ui -->|"saves backgrounds"| node_saved_backgrounds
node_background_engine -.->|"supplies SVG generation"| node_saved_backgrounds
node_user -->|"exports CSS"| node_background_css_export
node_user -->|"requests site export"| node_export_controller
node_export_controller -->|"reads project"| node_site_state
node_export_controller -->|"generates HTML"| node_renderer
node_export_controller -->|"downloads output"| node_html_zip
node_background_ui -->|"requests background name"| node_dialogs

click node_home_ui "https://github.com/shokydo/ysite-forger/blob/main/js/home.js"
click node_project_library "https://github.com/shokydo/ysite-forger/blob/main/js/projects.js"
click node_dialogs "https://github.com/shokydo/ysite-forger/blob/main/js/dialogs.js"
click node_editor_controller "https://github.com/shokydo/ysite-forger/blob/main/js/app.js"
click node_pages "https://github.com/shokydo/ysite-forger/blob/main/js/pages.js"
click node_block_library "https://github.com/shokydo/ysite-forger/blob/main/js/blocks.js"
click node_drag_drop "https://github.com/shokydo/ysite-forger/blob/main/js/dragdrop.js"
click node_settings_panel "https://github.com/shokydo/ysite-forger/blob/main/js/panel.js"
click node_renderer "https://github.com/shokydo/ysite-forger/blob/main/js/renderer.js"
click node_site_state "https://github.com/shokydo/ysite-forger/blob/main/js/store.js"
click node_background_ui "https://github.com/shokydo/ysite-forger/blob/main/js/bglab-ui.js"
click node_background_engine "https://github.com/shokydo/ysite-forger/blob/main/js/bglab-core.js"
click node_saved_backgrounds "https://github.com/shokydo/ysite-forger/blob/main/js/backgrounds.js"
click node_background_css_export "https://github.com/shokydo/ysite-forger/tree/main/js"
click node_export_controller "https://github.com/shokydo/ysite-forger/blob/main/js/export.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_home_ui,node_project_library,node_dialogs toneBlue
class node_editor_controller,node_pages,node_block_library,node_drag_drop,node_settings_panel,node_renderer toneAmber
class node_background_ui,node_background_engine,node_saved_backgrounds,node_background_css_export toneMint
class node_site_state,node_local_storage toneRose
class node_export_controller,node_html_zip,node_user toneIndigo
```

## Components

### Project home

- [Home workflow](https://github.com/shokydo/ysite-forger/blob/main/js/home.js): `js/home.js`
- [Project library](https://github.com/shokydo/ysite-forger/blob/main/js/projects.js): `js/projects.js`
- [Prompts](https://github.com/shokydo/ysite-forger/blob/main/js/dialogs.js): `js/dialogs.js`

### Site editor

- [Editor controller](https://github.com/shokydo/ysite-forger/blob/main/js/app.js): `js/app.js`
- [Page manager](https://github.com/shokydo/ysite-forger/blob/main/js/pages.js): `js/pages.js`
- [Block library](https://github.com/shokydo/ysite-forger/blob/main/js/blocks.js): `js/blocks.js`
- [Canvas drag-drop](https://github.com/shokydo/ysite-forger/blob/main/js/dragdrop.js): `js/dragdrop.js`
- [Block settings](https://github.com/shokydo/ysite-forger/blob/main/js/panel.js): `js/panel.js`
- [Canvas renderer](https://github.com/shokydo/ysite-forger/blob/main/js/renderer.js): `js/renderer.js`

### BG·LAB

- [Background editor UI](https://github.com/shokydo/ysite-forger/blob/main/js/bglab-ui.js): `js/bglab-ui.js`
- [SVG and FX engine](https://github.com/shokydo/ysite-forger/blob/main/js/bglab-core.js): `js/bglab-core.js`
- [Saved backgrounds](https://github.com/shokydo/ysite-forger/blob/main/js/backgrounds.js): `js/backgrounds.js`
- [CSS export](https://github.com/shokydo/ysite-forger/tree/main/js): `js`

### Browser storage

- [Site state](https://github.com/shokydo/ysite-forger/blob/main/js/store.js): `js/store.js`
- **Browser localStorage**

### Export

- [Site export](https://github.com/shokydo/ysite-forger/blob/main/js/export.js): `js/export.js`
- **HTML or ZIP**

### Other components

- **Site creator**

## Connections

- Site creator → Home workflow: creates or opens (evidence: `README.md`)
- Home workflow → Project library: manages projects (evidence: `js/home.js`)
- Home workflow → Prompts: prompts (evidence: `js/home.js`)
- Home workflow → Canvas renderer: renders preview (evidence: `js/home.js`)
- Home workflow → Editor controller: opens editor
- Site creator → Editor controller: edits site (evidence: `README.md`)
- Editor controller → Site state: reads and updates (evidence: `js/app.js`)
- Editor controller → Canvas renderer: renders canvas (evidence: `js/app.js`)
- Editor controller → Saved backgrounds: loads page background (evidence: `js/app.js`)
- Page manager → Site state: manages pages (evidence: `js/pages.js`)
- Canvas drag-drop → Site state: adds and moves blocks (evidence: `js/dragdrop.js`)
- Block library → Canvas drag-drop: provides block types
- Block settings → Site state: updates block (evidence: `js/panel.js`)
- Block settings → Saved backgrounds: loads thumbnails (evidence: `js/panel.js`)
- Canvas renderer → Saved backgrounds: embeds backgrounds (evidence: `js/renderer.js`)
- Project library → Browser localStorage: persists projects
- Saved backgrounds → Browser localStorage: persists backgrounds (evidence: `js/backgrounds.js`)
- Site creator → Background editor UI: edits backgrounds (evidence: `README.md`)
- Background editor UI → SVG and FX engine: builds background artwork
- Background editor UI → Saved backgrounds: saves backgrounds (evidence: `js/bglab-ui.js`)
- SVG and FX engine → Saved backgrounds: supplies SVG generation
- Site creator → CSS export: exports CSS (evidence: `README.md`)
- Site creator → Site export: requests site export (evidence: `js/export.js`)
- Site export → Site state: reads project (evidence: `js/export.js`)
- Site export → Canvas renderer: generates HTML (evidence: `js/export.js`)
- Site export → HTML or ZIP: downloads output (evidence: `js/export.js`)
- Background editor UI → Prompts: requests background name (evidence: `js/bglab-ui.js`)
