# doodle321/local-ftp-client-browser- architecture

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

- Interactive diagram: https://gitdiagram.com/doodle321/local-ftp-client-browser-
- Repository: https://github.com/doodle321/local-ftp-client-browser-

## Overview

This is a single-file LAN web FTP client. A user opens its browser interface, supplies FTP connection details, and the server uses basic-ftp to access the remote server. The excerpt shows the browser calling the connection endpoint and server handlers performing directory listing, downloads, uploads, directory creation, and deletion. These responsibilities share one implementation file; other UI-to-endpoint links are omitted where the excerpts do not show them.

Main entry points: [`ftp-client.js`](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js) (FTP web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser interface"]
  node_ui["FTP web interface<br/>[ftp-client.js]"]
end

subgraph group_server["Application server"]
  node_connect["Connection endpoint<br/>[ftp-client.js]"]
  node_listing["Directory listing<br/>[ftp-client.js]"]
  node_download["File download<br/>[ftp-client.js]"]
  node_upload["File upload<br/>[ftp-client.js]"]
  node_directory["Directory creation<br/>[ftp-client.js]"]
  node_deletion["File deletion<br/>[ftp-client.js]"]
end

subgraph group_remote["Remote FTP"]
  node_ftp["FTP server"]
end

node_user(("Local user"))

node_user -->|"opens"| node_ui
node_ui -->|"requests connection"| node_connect
node_connect -->|"authenticates"| node_ftp
node_listing -->|"lists directory"| node_ftp
node_download -->|"downloads file"| node_ftp
node_upload -->|"uploads file"| node_ftp
node_directory -->|"creates directory"| node_ftp
node_deletion -->|"checks and deletes"| node_ftp

click node_ui "https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js"
click node_connect "https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js"
click node_listing "https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js"
click node_download "https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js"
click node_upload "https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js"
click node_directory "https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js"
click node_deletion "https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.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_ui,node_user toneBlue
class node_connect,node_listing,node_download,node_upload,node_directory,node_deletion toneAmber
class node_ftp toneMint
```

## Components

### Browser interface

- [FTP web interface](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js): `ftp-client.js`

### Application server

- [Connection endpoint](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js): `ftp-client.js`
- [Directory listing](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js): `ftp-client.js`
- [File download](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js): `ftp-client.js`
- [File upload](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js): `ftp-client.js`
- [Directory creation](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js): `ftp-client.js`
- [File deletion](https://github.com/doodle321/local-ftp-client-browser-/blob/main/ftp-client.js): `ftp-client.js`

### Remote FTP

- **FTP server**

### Other components

- **Local user**

## Connections

- Local user → FTP web interface: opens (evidence: `README.md`)
- FTP web interface → Connection endpoint: requests connection (evidence: `ftp-client.js`)
- Connection endpoint → FTP server: authenticates (evidence: `ftp-client.js`)
- Directory listing → FTP server: lists directory (evidence: `ftp-client.js`)
- File download → FTP server: downloads file (evidence: `ftp-client.js`)
- File upload → FTP server: uploads file (evidence: `ftp-client.js`)
- Directory creation → FTP server: creates directory (evidence: `ftp-client.js`)
- File deletion → FTP server: checks and deletes (evidence: `ftp-client.js`)
