# donlon/cloudflare-error-page architecture

> Architecture diagram of the GitHub repository donlon/cloudflare-error-page, 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/donlon/cloudflare-error-page
- Repository: https://github.com/donlon/cloudflare-error-page

## Overview

Cloudflare Error Page Generator provides Python and JavaScript renderers plus a browser-based editor. The main workflow is user configuration in the editor, rendering through the JavaScript package, and preview or export; the Flask service also serves examples and supports saved share links. The editor additionally generates JavaScript, JSON, and Python snippets. Server route wiring and renderer calls are visible in excerpts; some frontend details and the examples data source are not fully shown.

Main entry points: [`editor/web/src/index.js`](https://github.com/donlon/cloudflare-error-page/blob/main/editor/web/src/index.js) (Editor UI), [`editor/server/app/__init__.py`](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/__init__.py) (Flask app setup), [`editor/server/app/share.py`](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/share.py) (Share routes), [`editor/server/app/utils.py`](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/utils.py) (Render utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rendering["Page rendering"]
  node_js_renderer["JavaScript renderer<br/>[index.ts]"]
  node_js_template["JavaScript template<br/>[template.ejs]"]
  node_py_renderer["Python renderer<br/>[__init__.py]"]
  node_py_template["Python template<br/>[template.html]"]
end

subgraph group_editor["Browser editor"]
  node_editor_ui["Editor UI<br/>[index.js]"]
  node_form_config["Page settings<br/>[index.js]"]
  node_preview["Rendered preview"]
  node_export_code["Code examples<br/>[index.ts]"]
end

subgraph group_server["Editor service"]
  node_editor_routes["Editor routes<br/>[editor.py]"]
  node_examples_routes["Example pages<br/>[examples.py]"]
  node_server_utils["Render utilities<br/>[utils.py]"]
  node_app_setup["Flask app setup<br/>[__init__.py]"]
end

subgraph group_sharing["Saved pages"]
  node_share_routes["Share routes<br/>[share.py]"]
  node_share_model["Saved page model<br/>[models.py]"]
  node_database[("Configured database")]
end

node_user(("User"))
node_browser(("Web browser"))

node_user -->|"configures"| node_editor_ui
node_editor_ui -->|"edits settings"| node_form_config
node_editor_ui -->|"renders with"| node_js_renderer
node_js_renderer -->|"renders template"| node_js_template
node_editor_ui -->|"updates preview"| node_preview
node_editor_ui -->|"generates examples"| node_export_code
node_user -->|"views or exports"| node_browser
node_browser -->|"requests editor"| node_editor_routes
node_app_setup -->|"registers routes"| node_editor_routes
node_app_setup -->|"registers routes"| node_examples_routes
node_app_setup -->|"registers routes"| node_share_routes
node_examples_routes -->|"renders through"| node_server_utils
node_share_routes -->|"renders through"| node_server_utils
node_server_utils -->|"renders with"| node_py_renderer
node_py_renderer -->|"loads template"| node_py_template
node_share_routes -->|"creates and reads"| node_share_model
node_app_setup -->|"initializes schema"| node_database
node_share_model -.->|"persists parameters"| node_database
node_editor_ui -->|"requests saved links"| node_share_routes

click node_editor_ui "https://github.com/donlon/cloudflare-error-page/blob/main/editor/web/src/index.js"
click node_form_config "https://github.com/donlon/cloudflare-error-page/blob/main/editor/web/src/index.js"
click node_export_code "https://github.com/donlon/cloudflare-error-page/blob/main/editor/web/src/codegen/index.ts"
click node_js_renderer "https://github.com/donlon/cloudflare-error-page/blob/main/javascript/src/index.ts"
click node_js_template "https://github.com/donlon/cloudflare-error-page/blob/main/javascript/src/templates/template.ejs"
click node_py_renderer "https://github.com/donlon/cloudflare-error-page/blob/main/cloudflare_error_page/__init__.py"
click node_py_template "https://github.com/donlon/cloudflare-error-page/blob/main/cloudflare_error_page/templates/template.html"
click node_editor_routes "https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/editor.py"
click node_examples_routes "https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/examples.py"
click node_server_utils "https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/utils.py"
click node_app_setup "https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/__init__.py"
click node_share_routes "https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/share.py"
click node_share_model "https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/models.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_js_renderer,node_js_template,node_py_renderer,node_py_template,node_user,node_browser toneBlue
class node_editor_ui,node_form_config,node_preview,node_export_code toneAmber
class node_editor_routes,node_examples_routes,node_server_utils,node_app_setup toneMint
class node_share_routes,node_share_model,node_database toneRose
```

## Components

### Page rendering

- [JavaScript renderer](https://github.com/donlon/cloudflare-error-page/blob/main/javascript/src/index.ts): `javascript/src/index.ts`
- [JavaScript template](https://github.com/donlon/cloudflare-error-page/blob/main/javascript/src/templates/template.ejs): `javascript/src/templates/template.ejs`
- [Python renderer](https://github.com/donlon/cloudflare-error-page/blob/main/cloudflare_error_page/__init__.py): `cloudflare_error_page/__init__.py`
- [Python template](https://github.com/donlon/cloudflare-error-page/blob/main/cloudflare_error_page/templates/template.html): `cloudflare_error_page/templates/template.html`

### Browser editor

- [Editor UI](https://github.com/donlon/cloudflare-error-page/blob/main/editor/web/src/index.js): `editor/web/src/index.js`
- [Page settings](https://github.com/donlon/cloudflare-error-page/blob/main/editor/web/src/index.js): `editor/web/src/index.js`
- **Rendered preview**
- [Code examples](https://github.com/donlon/cloudflare-error-page/blob/main/editor/web/src/codegen/index.ts): `editor/web/src/codegen/index.ts`

### Editor service

- [Editor routes](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/editor.py): `editor/server/app/editor.py`
- [Example pages](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/examples.py): `editor/server/app/examples.py`
- [Render utilities](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/utils.py): `editor/server/app/utils.py`
- [Flask app setup](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/__init__.py): `editor/server/app/__init__.py`

### Saved pages

- [Share routes](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/share.py): `editor/server/app/share.py`
- [Saved page model](https://github.com/donlon/cloudflare-error-page/blob/main/editor/server/app/models.py): `editor/server/app/models.py`
- **Configured database**

### Other components

- **User**
- **Web browser**

## Connections

- User → Editor UI: configures (evidence: `README.md`)
- Editor UI → Page settings: edits settings (evidence: `editor/web/src/index.js`)
- Editor UI → JavaScript renderer: renders with (evidence: `editor/web/src/index.js`)
- JavaScript renderer → JavaScript template: renders template (evidence: `javascript/src/index.ts`)
- Editor UI → Rendered preview: updates preview (evidence: `editor/web/src/index.js`)
- Editor UI → Code examples: generates examples (evidence: `editor/web/src/index.js`)
- User → Web browser: views or exports (evidence: `README.md`)
- Web browser → Editor routes: requests editor
- Flask app setup → Editor routes: registers routes (evidence: `editor/server/app/__init__.py`)
- Flask app setup → Example pages: registers routes (evidence: `editor/server/app/__init__.py`)
- Flask app setup → Share routes: registers routes (evidence: `editor/server/app/__init__.py`)
- Example pages → Render utilities: renders through (evidence: `editor/server/app/examples.py`)
- Share routes → Render utilities: renders through (evidence: `editor/server/app/share.py`)
- Render utilities → Python renderer: renders with (evidence: `editor/server/app/utils.py`)
- Python renderer → Python template: loads template (evidence: `cloudflare_error_page/__init__.py`)
- Share routes → Saved page model: creates and reads (evidence: `editor/server/app/share.py`)
- Flask app setup → Configured database: initializes schema (evidence: `editor/server/app/__init__.py`)
- Saved page model → Configured database: persists parameters
- Editor UI → Share routes: requests saved links (evidence: `editor/web/src/index.js`)
