# frnlol/frn architecture

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

- Interactive diagram: https://gitdiagram.com/frnlol/frn
- Repository: https://github.com/frnlol/frn

## Overview

The repository appears to be a browser-based web proxy/runtime, with a service-worker layer routing proxied requests and a frame-side client that initializes the rewriting engine and communicates with that worker. A separate extension subsystem serves locally stored extension files. The tree also includes a large application bundle and a signed-release service worker, but the README is empty and the bundle and main runtime excerpt are incomplete; several product capabilities and links therefore cannot be established confidently.

Main entry points: [`b/zqz5g/70wt6c.js`](https://github.com/frnlol/frn/blob/main/b/zqz5g/70wt6c.js) (Frame client), [`b/assets/bundle-1oxptspd.js`](https://github.com/frnlol/frn/blob/main/b/assets/bundle-1oxptspd.js) (Web application), [`b/zqz5g/thnd7d.js`](https://github.com/frnlol/frn/blob/main/b/zqz5g/thnd7d.js) (Frame controller), [`b/zqz5g/rbe2ea.js`](https://github.com/frnlol/frn/blob/main/b/zqz5g/rbe2ea.js) (Proxy service worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_proxy["Proxy Runtime"]
  node_proxyworker["Proxy service worker<br/>[rbe2ea.js]"]
  node_frameclient["Frame client<br/>[70wt6c.js]"]
  node_framecontroller["Frame controller<br/>[thnd7d.js]"]
  node_proxyengine["Proxy engine<br/>[93ngke.js]"]
end

subgraph group_extensions["Extensions"]
  node_extensionsw["Extension router<br/>[irvrg0.js]"]
  node_extensiondata[("Extension database<br/>[tqctx9.js]")]
end

subgraph group_release["Release Runtime"]
  node_releaseworker["Release service worker<br/>[v7m.js]"]
end

subgraph group_app["Application Assets"]
  node_webapp["Web application<br/>[bundle-1oxptspd.js]"]
  node_appdata["Application datasets"]
end

node_visitor(("Browser user"))
node_remotehost["Release sources"]

node_visitor -->|"uses"| node_webapp
node_webapp -.->|"creates frame"| node_framecontroller
node_framecontroller -->|"injects client"| node_frameclient
node_frameclient -->|"loads engine"| node_proxyengine
node_frameclient -->|"initializes transport"| node_proxyworker
node_proxyworker -.->|"dispatches transport"| node_framecontroller
node_visitor -.->|"requests extension files"| node_extensionsw
node_extensionsw -->|"reads files"| node_extensiondata
node_releaseworker -->|"fetches releases"| node_remotehost
node_webapp -.->|"loads datasets"| node_appdata

click node_webapp "https://github.com/frnlol/frn/blob/main/b/assets/bundle-1oxptspd.js"
click node_proxyworker "https://github.com/frnlol/frn/blob/main/b/zqz5g/rbe2ea.js"
click node_frameclient "https://github.com/frnlol/frn/blob/main/b/zqz5g/70wt6c.js"
click node_framecontroller "https://github.com/frnlol/frn/blob/main/b/zqz5g/thnd7d.js"
click node_proxyengine "https://github.com/frnlol/frn/blob/main/b/k18qb/93ngke.js"
click node_extensionsw "https://github.com/frnlol/frn/blob/main/b/irvrg0.js"
click node_extensiondata "https://github.com/frnlol/frn/blob/main/b/tqctx9.js"
click node_releaseworker "https://github.com/frnlol/frn/blob/main/v7m.js"
click node_appdata "https://github.com/frnlol/frn/tree/main/b/assets/json"

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_proxyworker,node_frameclient,node_framecontroller,node_proxyengine,node_visitor toneBlue
class node_extensionsw,node_extensiondata toneAmber
class node_releaseworker toneMint
class node_webapp,node_appdata toneRose
class node_remotehost toneIndigo
```

## Components

### Proxy Runtime

- [Proxy service worker](https://github.com/frnlol/frn/blob/main/b/zqz5g/rbe2ea.js): `b/zqz5g/rbe2ea.js`
- [Frame client](https://github.com/frnlol/frn/blob/main/b/zqz5g/70wt6c.js): `b/zqz5g/70wt6c.js`
- [Frame controller](https://github.com/frnlol/frn/blob/main/b/zqz5g/thnd7d.js): `b/zqz5g/thnd7d.js`
- [Proxy engine](https://github.com/frnlol/frn/blob/main/b/k18qb/93ngke.js): `b/k18qb/93ngke.js`

### Extensions

- [Extension router](https://github.com/frnlol/frn/blob/main/b/irvrg0.js): `b/irvrg0.js`
- [Extension database](https://github.com/frnlol/frn/blob/main/b/tqctx9.js): `b/tqctx9.js`

### Release Runtime

- [Release service worker](https://github.com/frnlol/frn/blob/main/v7m.js): `v7m.js`

### Application Assets

- [Web application](https://github.com/frnlol/frn/blob/main/b/assets/bundle-1oxptspd.js): `b/assets/bundle-1oxptspd.js`
- [Application datasets](https://github.com/frnlol/frn/tree/main/b/assets/json): `b/assets/json`

### Other components

- **Browser user**
- **Release sources**

## Connections

- Browser user → Web application: uses
- Web application → Frame controller: creates frame
- Frame controller → Frame client: injects client (evidence: `b/zqz5g/thnd7d.js`)
- Frame client → Proxy engine: loads engine (evidence: `b/zqz5g/70wt6c.js`)
- Frame client → Proxy service worker: initializes transport (evidence: `b/zqz5g/70wt6c.js`)
- Proxy service worker → Frame controller: dispatches transport
- Browser user → Extension router: requests extension files
- Extension router → Extension database: reads files (evidence: `b/irvrg0.js`)
- Release service worker → Release sources: fetches releases (evidence: `v7m.js`)
- Web application → Application datasets: loads datasets
