# tud8951/cloudflare-imgbed architecture

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

## Overview

Cloudflare ImgBed is a file-hosting application for uploading, managing, and serving files through Cloudflare serverless deployments or a Docker/server runtime. Its main user workflow is authenticated upload, channel-backed storage with metadata/index updates, then file retrieval or management. The graph also includes documented WebDAV, random-file, administration, and storage-channel capabilities. Some routes and integrations are represented from the README and source index rather than inspected source; those links are cited as documentation or left unconnected where wiring is uncertain.

Main entry points: [`functions/upload/index.js`](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/upload/index.js) (Upload Handler), [`functions/utils/databaseAdapter.js`](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/databaseAdapter.js) (Database Adapter), [`functions/file/[[path]].js`](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/file/%5B%5Bpath%5D%5D.js) (File Retrieval), [`functions/utils/indexManager.js`](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/indexManager.js) (File Index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request Entry"]
  node_worker["Worker Router<br/>[index.js]"]
  node_auth["Authentication<br/>[authCore.js]"]
end

subgraph group_upload["Upload Lifecycle"]
  node_upload_api["Upload Handler<br/>[index.js]"]
  node_chunk_upload["Chunk Upload<br/>[chunkUpload.js]"]
  node_upload_tools["Upload Utilities<br/>[uploadTools.js]"]
end

subgraph group_files["Files and Discovery"]
  node_file_api["File Retrieval<br/>[&#91;&#91;path&#93;&#93;.js]"]
  node_management["File Management<br/>[list.js]"]
  node_public_gallery["Public Listing<br/>[list.js]"]
  node_random["Random Images<br/>[index.js]"]
  node_webdav["WebDAV Access<br/>[&#91;&#91;path&#93;&#93;.js]"]
end

subgraph group_admin["Administration"]
  node_admin_auth["Admin Login<br/>[adminLogin.js]"]
  node_api_tokens["API Tokens<br/>[apiTokens.js]"]
  node_system_config["System Settings<br/>[sysConfig.js]"]
  node_batch_ops["Batch and Restore<br/>[finalize.js]"]
  node_tags["Tag Management<br/>[batch.js]"]
end

subgraph group_platform["Data and Storage"]
  node_index["File Index<br/>[indexManager.js]"]
  node_database["Database Adapter<br/>[databaseAdapter.js]"]
  node_d1[("D1 Database<br/>[d1Database.js]")]
  node_telegram["Telegram Storage<br/>[telegramAPI.js]"]
  node_discord["Discord Storage<br/>[discordAPI.js]"]
  node_huggingface["Hugging Face Storage<br/>[huggingfaceAPI.js]"]
  node_webdav_storage["WebDAV Storage<br/>[webdavAPI.js]"]
end

node_user(("User"))
node_external_storage{{"Storage Services"}}

node_user -->|"sends requests"| node_worker
node_worker -->|"routes upload"| node_upload_api
node_worker -->|"routes file reads"| node_file_api
node_upload_api -->|"checks permission"| node_auth
node_upload_api -->|"loads settings"| node_system_config
node_upload_api -->|"uses utilities"| node_upload_tools
node_upload_api -->|"delegates large uploads"| node_chunk_upload
node_upload_api -->|"records metadata"| node_database
node_upload_api -.->|"uploads files"| node_telegram
node_upload_api -.->|"uploads files"| node_discord
node_upload_api -.->|"uploads files"| node_huggingface
node_upload_api -.->|"uploads files"| node_webdav_storage
node_chunk_upload -->|"uses helpers"| node_upload_tools
node_chunk_upload -->|"stores chunk state"| node_database
node_upload_tools -->|"updates index"| node_index
node_upload_tools -->|"stores file record"| node_database
node_file_api -->|"reads metadata"| node_database
node_file_api -->|"fetches file"| node_telegram
node_file_api -->|"fetches file"| node_discord
node_file_api -.->|"fetches file"| node_huggingface
node_file_api -.->|"fetches file"| node_webdav_storage
node_management -->|"lists indexed files"| node_index
node_management -->|"reads metadata"| node_database
node_public_gallery -->|"lists public files"| node_index
node_random -->|"selects indexed files"| node_index
node_webdav -->|"accesses records"| node_database
node_admin_auth -.->|"authenticates admin"| node_auth
node_api_tokens -->|"stores tokens"| node_database
node_system_config -->|"loads settings"| node_database
node_batch_ops -.->|"rebuilds index"| node_index
node_tags -.->|"stores tags"| node_database
node_database -->|"uses D1 adapter"| node_d1
node_telegram -.->|"calls service"| node_external_storage
node_discord -.->|"calls service"| node_external_storage
node_huggingface -.->|"calls service"| node_external_storage
node_webdav_storage -.->|"calls service"| node_external_storage

click node_worker "https://github.com/tud8951/cloudflare-imgbed/blob/main/deploy/worker/index.js"
click node_auth "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/auth/authCore.js"
click node_upload_api "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/upload/index.js"
click node_chunk_upload "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/upload/chunkUpload.js"
click node_upload_tools "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/upload/uploadTools.js"
click node_file_api "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/file/%5B%5Bpath%5D%5D.js"
click node_management "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/list.js"
click node_public_gallery "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/public/list.js"
click node_random "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/random/index.js"
click node_webdav "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/dav/%5B%5Bpath%5D%5D.js"
click node_admin_auth "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/auth/adminLogin.js"
click node_api_tokens "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/apiTokens.js"
click node_system_config "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/sysConfig.js"
click node_batch_ops "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/batch/index/finalize.js"
click node_tags "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/tags/batch.js"
click node_index "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/indexManager.js"
click node_database "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/databaseAdapter.js"
click node_d1 "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/d1Database.js"
click node_telegram "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/telegramAPI.js"
click node_discord "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/discordAPI.js"
click node_huggingface "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/huggingfaceAPI.js"
click node_webdav_storage "https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/webdavAPI.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_worker,node_auth,node_user toneBlue
class node_upload_api,node_chunk_upload,node_upload_tools,node_external_storage toneAmber
class node_file_api,node_management,node_public_gallery,node_random,node_webdav toneMint
class node_admin_auth,node_api_tokens,node_system_config,node_batch_ops,node_tags toneRose
class node_index,node_database,node_d1,node_telegram,node_discord,node_huggingface,node_webdav_storage toneIndigo
```

## Components

### Request Entry

- [Worker Router](https://github.com/tud8951/cloudflare-imgbed/blob/main/deploy/worker/index.js): `deploy/worker/index.js`
- [Authentication](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/auth/authCore.js): `functions/utils/auth/authCore.js`

### Upload Lifecycle

- [Upload Handler](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/upload/index.js): `functions/upload/index.js`
- [Chunk Upload](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/upload/chunkUpload.js): `functions/upload/chunkUpload.js`
- [Upload Utilities](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/upload/uploadTools.js): `functions/upload/uploadTools.js`

### Files and Discovery

- [File Retrieval](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/file/%5B%5Bpath%5D%5D.js): `functions/file/[[path]].js`
- [File Management](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/list.js): `functions/api/manage/list.js`
- [Public Listing](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/public/list.js): `functions/api/public/list.js`
- [Random Images](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/random/index.js): `functions/random/index.js`
- [WebDAV Access](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/dav/%5B%5Bpath%5D%5D.js): `functions/dav/[[path]].js`

### Administration

- [Admin Login](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/auth/adminLogin.js): `functions/api/auth/adminLogin.js`
- [API Tokens](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/apiTokens.js): `functions/api/manage/apiTokens.js`
- [System Settings](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/sysConfig.js): `functions/utils/sysConfig.js`
- [Batch and Restore](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/batch/index/finalize.js): `functions/api/manage/batch/index/finalize.js`
- [Tag Management](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/api/manage/tags/batch.js): `functions/api/manage/tags/batch.js`

### Data and Storage

- [File Index](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/indexManager.js): `functions/utils/indexManager.js`
- [Database Adapter](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/databaseAdapter.js): `functions/utils/databaseAdapter.js`
- [D1 Database](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/d1Database.js): `functions/utils/d1Database.js`
- [Telegram Storage](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/telegramAPI.js): `functions/utils/storage/telegramAPI.js`
- [Discord Storage](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/discordAPI.js): `functions/utils/storage/discordAPI.js`
- [Hugging Face Storage](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/huggingfaceAPI.js): `functions/utils/storage/huggingfaceAPI.js`
- [WebDAV Storage](https://github.com/tud8951/cloudflare-imgbed/blob/main/functions/utils/storage/webdavAPI.js): `functions/utils/storage/webdavAPI.js`

### Other components

- **User**
- **Storage Services**

## Connections

- User → Worker Router: sends requests (evidence: `README.md`)
- Worker Router → Upload Handler: routes upload (evidence: `deploy/worker/index.js`)
- Worker Router → File Retrieval: routes file reads (evidence: `deploy/worker/index.js`)
- Upload Handler → Authentication: checks permission (evidence: `functions/upload/index.js`)
- Upload Handler → System Settings: loads settings (evidence: `functions/upload/index.js`)
- Upload Handler → Upload Utilities: uses utilities (evidence: `functions/upload/index.js`)
- Upload Handler → Chunk Upload: delegates large uploads (evidence: `functions/upload/index.js`)
- Upload Handler → Database Adapter: records metadata (evidence: `functions/upload/index.js`)
- Upload Handler → Telegram Storage: uploads files (evidence: `functions/upload/index.js`)
- Upload Handler → Discord Storage: uploads files (evidence: `functions/upload/index.js`)
- Upload Handler → Hugging Face Storage: uploads files (evidence: `functions/upload/index.js`)
- Upload Handler → WebDAV Storage: uploads files (evidence: `functions/upload/index.js`)
- Chunk Upload → Upload Utilities: uses helpers (evidence: `functions/upload/chunkUpload.js`)
- Chunk Upload → Database Adapter: stores chunk state (evidence: `functions/upload/chunkUpload.js`)
- Upload Utilities → File Index: updates index (evidence: `functions/upload/uploadTools.js`)
- Upload Utilities → Database Adapter: stores file record (evidence: `functions/upload/uploadTools.js`)
- File Retrieval → Database Adapter: reads metadata (evidence: `functions/file/[[path]].js`)
- File Retrieval → Telegram Storage: fetches file (evidence: `functions/file/[[path]].js`)
- File Retrieval → Discord Storage: fetches file (evidence: `functions/file/[[path]].js`)
- File Retrieval → Hugging Face Storage: fetches file (evidence: `functions/file/[[path]].js`)
- File Retrieval → WebDAV Storage: fetches file (evidence: `functions/file/[[path]].js`)
- File Management → File Index: lists indexed files (evidence: `functions/api/manage/list.js`)
- File Management → Database Adapter: reads metadata (evidence: `functions/api/manage/list.js`)
- Public Listing → File Index: lists public files (evidence: `functions/api/public/list.js`)
- Random Images → File Index: selects indexed files (evidence: `functions/random/index.js`)
- WebDAV Access → Database Adapter: accesses records (evidence: `functions/dav/[[path]].js`)
- Admin Login → Authentication: authenticates admin
- API Tokens → Database Adapter: stores tokens (evidence: `functions/api/manage/apiTokens.js`)
- System Settings → Database Adapter: loads settings (evidence: `functions/utils/sysConfig.js`)
- Batch and Restore → File Index: rebuilds index
- Tag Management → Database Adapter: stores tags
- Database Adapter → D1 Database: uses D1 adapter (evidence: `functions/utils/databaseAdapter.js`)
- Telegram Storage → Storage Services: calls service (evidence: `README.md`)
- Discord Storage → Storage Services: calls service (evidence: `README.md`)
- Hugging Face Storage → Storage Services: calls service (evidence: `README.md`)
- WebDAV Storage → Storage Services: calls service (evidence: `README.md`)
