# leandrolsouza/fedexe-api-delivery architecture

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

- Interactive diagram: https://gitdiagram.com/leandrolsouza/fedexe-api-delivery
- Repository: https://github.com/leandrolsouza/fedexe-api-delivery

## Overview

Fedexe API is a local-first desktop HTTP client built with a React interface and a Rust/Tauri runtime, with a browser preview and a CLI runner. The main workflow is editing a request in a collection, resolving environment variables and authorization, sending it through the selected transport, and inspecting the response; collection runs add scripted checks, extraction, and reports. The graph also preserves documented import, backup, load-testing, persistence, OAuth, and update capabilities. Some subsystem links are based on README statements because their implementation excerpts were not provided.

Main entry points: [`ui/src/App.tsx`](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/App.tsx) (Workspace shell), [`ui/src/lib/transport.ts`](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/transport.ts) (Request transport), [`src/http.rs`](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http.rs) (HTTP engine), [`ui/src/components/RequestEditor.tsx`](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/RequestEditor.tsx) (Request editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Workspace interface"]
  node_app["Workspace shell<br/>[App.tsx]"]
  node_editor["Request editor<br/>[RequestEditor.tsx]"]
  node_pair["Pair editor<br/>[PairEditor.tsx]"]
  node_views["Workspace views<br/>[WorkspaceViews.tsx]"]
  node_models["Workspace models<br/>[models.ts]"]
  node_backupui["Backup controls<br/>[DriveBackups.tsx]"]
end

subgraph group_request["Request execution"]
  node_transport["Request transport<br/>[transport.ts]"]
end

subgraph group_runtime["Desktop runtime"]
  node_http["HTTP engine<br/>[http.rs]"]
  node_oauth["OAuth sessions<br/>[oauth.rs]"]
  node_console["Request console<br/>[console.rs]"]
  node_loadengine["Load test engine<br/>[load.rs]"]
end

subgraph group_workspace["Workspace services"]
  node_drive["Drive backups<br/>[drive.rs]"]
  node_postmanui["Postman import"]
  node_postman["Postman conversion<br/>[postman.rs]"]
  node_workspacefile[("Workspace persistence<br/>[workspace.rs]")]
  node_updates["Update checks<br/>[updates.rs]"]
end

subgraph group_automation["Automation"]
  node_collectionrunner["Collection runner"]
  node_scripts["Scripts and tests<br/>[scripts.ts]"]
  node_loadui["Load test controls<br/>[LoadRunner.tsx]"]
  node_cli["CLI runner<br/>[cli.rs]"]
end

node_user(("API developer"))
node_api(("API service"))

node_user -->|"uses"| node_app
node_app -.->|"opens requests"| node_editor
node_editor -->|"edits fields"| node_pair
node_app -->|"loads workspace"| node_models
node_views -->|"runs collection"| node_transport
node_transport -->|"invokes desktop"| node_http
node_transport -->|"sends browser requests"| node_api
node_http -->|"sends HTTP"| node_api
node_editor -.->|"sends requests"| node_transport
node_app -->|"shows console"| node_console
node_http -->|"delegates OAuth"| node_oauth
node_oauth -.->|"exchanges tokens"| node_api
node_app -->|"offers backups"| node_backupui
node_backupui -->|"manages backups"| node_drive
node_app -->|"opens importer"| node_postmanui
node_postmanui -.->|"converts collection"| node_postman
node_app -->|"persists workspace"| node_workspacefile
node_app -->|"checks releases"| node_updates
node_views -->|"prepares runs"| node_collectionrunner
node_transport -->|"runs hooks"| node_scripts
node_loadui -.->|"runs load test"| node_transport
node_http -.->|"dispatches load runs"| node_loadengine
node_user -->|"runs collections"| node_cli
node_cli -->|"executes requests"| node_api

click node_app "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/App.tsx"
click node_editor "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/RequestEditor.tsx"
click node_pair "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/PairEditor.tsx"
click node_views "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/WorkspaceViews.tsx"
click node_models "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/models.ts"
click node_transport "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/transport.ts"
click node_http "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http.rs"
click node_oauth "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http/oauth.rs"
click node_console "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http/console.rs"
click node_drive "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/drive.rs"
click node_backupui "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/DriveBackups.tsx"
click node_postmanui "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/PostmanWorkspaceDialog.tsx"
click node_postman "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/postman.rs"
click node_workspacefile "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/workspace.rs"
click node_updates "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/updates.rs"
click node_collectionrunner "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/collection-runner.ts"
click node_scripts "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/scripts.ts"
click node_loadui "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/LoadRunner.tsx"
click node_loadengine "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http/load.rs"
click node_cli "https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/cli.rs"

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_app,node_editor,node_pair,node_views,node_models,node_backupui toneBlue
class node_transport toneAmber
class node_http,node_oauth,node_console,node_loadengine,node_user,node_api toneMint
class node_drive,node_postmanui,node_postman,node_workspacefile,node_updates toneRose
class node_collectionrunner,node_scripts,node_loadui,node_cli toneIndigo
```

## Components

### Workspace interface

- [Workspace shell](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/App.tsx): `ui/src/App.tsx`
- [Request editor](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/RequestEditor.tsx): `ui/src/components/RequestEditor.tsx`
- [Pair editor](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/PairEditor.tsx): `ui/src/components/PairEditor.tsx`
- [Workspace views](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/WorkspaceViews.tsx): `ui/src/components/WorkspaceViews.tsx`
- [Workspace models](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/models.ts): `ui/src/lib/models.ts`
- [Backup controls](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/DriveBackups.tsx): `ui/src/components/DriveBackups.tsx`

### Request execution

- [Request transport](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/transport.ts): `ui/src/lib/transport.ts`

### Desktop runtime

- [HTTP engine](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http.rs): `src/http.rs`
- [OAuth sessions](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http/oauth.rs): `src/http/oauth.rs`
- [Request console](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http/console.rs): `src/http/console.rs`
- [Load test engine](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/http/load.rs): `src/http/load.rs`

### Workspace services

- [Drive backups](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/drive.rs): `src/drive.rs`
- [Postman import](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/PostmanWorkspaceDialog.tsx): `ui/src/components/PostmanWorkspaceDialog.tsx`
- [Postman conversion](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/postman.rs): `src/postman.rs`
- [Workspace persistence](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/workspace.rs): `src/workspace.rs`
- [Update checks](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/updates.rs): `src/updates.rs`

### Automation

- [Collection runner](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/collection-runner.ts): `ui/src/lib/collection-runner.ts`
- [Scripts and tests](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/lib/scripts.ts): `ui/src/lib/scripts.ts`
- [Load test controls](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/ui/src/components/LoadRunner.tsx): `ui/src/components/LoadRunner.tsx`
- [CLI runner](https://github.com/leandrolsouza/fedexe-api-delivery/blob/main/src/cli.rs): `src/cli.rs`

### Other components

- **API developer**
- **API service**

## Connections

- API developer → Workspace shell: uses (evidence: `README.md`)
- Workspace shell → Request editor: opens requests (evidence: `ui/src/App.tsx`)
- Request editor → Pair editor: edits fields (evidence: `ui/src/components/RequestEditor.tsx`)
- Workspace shell → Workspace models: loads workspace (evidence: `ui/src/App.tsx`)
- Workspace views → Request transport: runs collection (evidence: `ui/src/components/WorkspaceViews.tsx`)
- Request transport → HTTP engine: invokes desktop (evidence: `ui/src/lib/transport.ts`)
- Request transport → API service: sends browser requests (evidence: `README.md`)
- HTTP engine → API service: sends HTTP (evidence: `README.md`)
- Request editor → Request transport: sends requests (evidence: `ui/src/components/RequestEditor.tsx`)
- Workspace shell → Request console: shows console (evidence: `ui/src/App.tsx`)
- HTTP engine → OAuth sessions: delegates OAuth (evidence: `src/http.rs`)
- OAuth sessions → API service: exchanges tokens
- Workspace shell → Backup controls: offers backups (evidence: `ui/src/App.tsx`)
- Backup controls → Drive backups: manages backups (evidence: `README.md`)
- Workspace shell → Postman import: opens importer (evidence: `ui/src/App.tsx`)
- Postman import → Postman conversion: converts collection
- Workspace shell → Workspace persistence: persists workspace (evidence: `README.md`)
- Workspace shell → Update checks: checks releases (evidence: `README.md`)
- Workspace views → Collection runner: prepares runs (evidence: `ui/src/components/WorkspaceViews.tsx`)
- Request transport → Scripts and tests: runs hooks (evidence: `ui/src/lib/transport.ts`)
- Load test controls → Request transport: runs load test (evidence: `ui/src/components/LoadRunner.tsx`)
- HTTP engine → Load test engine: dispatches load runs (evidence: `src/http.rs`)
- API developer → CLI runner: runs collections (evidence: `README.md`)
- CLI runner → API service: executes requests (evidence: `README.md`)
