# fordpepper/webproxy architecture

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

- Interactive diagram: https://gitdiagram.com/fordpepper/webproxy
- Repository: https://github.com/fordpepper/webproxy

## Overview

webproxy is a small host-run web proxy: the host fetches requested pages so a remote browser does not contact the real sites directly. The documented workflow is to run the host script, then use its printed link in a browser; the README also describes a hosted viewer that accepts an access key. Source excerpts were unavailable, so relationships are limited to those documented in the README.

Main entry points: [`webproxy.sh`](https://github.com/fordpepper/webproxy/blob/main/webproxy.sh) (Proxy host), [`index.html`](https://github.com/fordpepper/webproxy/blob/main/index.html) (Viewer page)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_host["Proxy host<br/>[webproxy.sh]"]
node_viewer["Viewer page<br/>[index.html]"]
node_browser(("Remote browser"))
node_sites(("Real websites"))

node_browser -->|"opens link"| node_host
node_host -->|"fetches pages"| node_sites
node_browser -->|"opens viewer"| node_viewer
node_viewer -.->|"uses access key"| node_host

click node_host "https://github.com/fordpepper/webproxy/blob/main/webproxy.sh"
click node_viewer "https://github.com/fordpepper/webproxy/blob/main/index.html"

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_host toneTeal
class node_viewer,node_browser toneBlue
class node_sites toneIndigo
```

## Components

### Other components

- [Proxy host](https://github.com/fordpepper/webproxy/blob/main/webproxy.sh): `webproxy.sh`
- [Viewer page](https://github.com/fordpepper/webproxy/blob/main/index.html): `index.html`
- **Remote browser**
- **Real websites**

## Connections

- Remote browser → Proxy host: opens link (evidence: `README.md`)
- Proxy host → Real websites: fetches pages (evidence: `README.md`)
- Remote browser → Viewer page: opens viewer (evidence: `README.md`)
- Viewer page → Proxy host: uses access key
