# enyo/dropzone architecture

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

- Interactive diagram: https://gitdiagram.com/enyo/dropzone
- Repository: https://github.com/enyo/dropzone

## Overview

Dropzone is a browser-side file upload library, accompanied by its documentation and product website. The principal workflow is to attach a Dropzone instance to an HTML element, accept files into its queue, present previews and progress, then send uploads with XHR to a configured server. The graph includes documented chunked and S3 multipart capabilities, plus the event and configuration layers. Some runtime stages are represented from README claims because their implementation was not sampled; those links are marked unverified.

Main entry points: [`packages/dropzone/src/dropzone.ts`](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts) (Dropzone instance), [`packages/dropzone/src/options.ts`](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/options.ts) (Configuration), [`packages/dropzone/src/extend.ts`](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/extend.ts) (Option merging), [`packages/dropzone/src/emitter.ts`](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/emitter.ts) (Event API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Upload runtime"]
  node_element["Dropzone element"]
  node_instance["Dropzone instance<br/>[dropzone.ts]"]
  node_options["Configuration<br/>[options.ts]"]
  node_extend["Option merging<br/>[extend.ts]"]
  node_intake["File intake<br/>[dropzone.ts]"]
  node_validation["File validation<br/>[dropzone.ts]"]
  node_queue["Upload queue<br/>[dropzone.ts]"]
  node_preview["File previews<br/>[options.ts]"]
  node_image["Image processing<br/>[dropzone.ts]"]
  node_upload["Upload dispatch<br/>[dropzone.ts]"]
  node_events["Event API<br/>[emitter.ts]"]
end

subgraph group_integration["Upload integrations"]
  node_xhr["XHR transport<br/>[dropzone.ts]"]
  node_server(("Upload server"))
  node_chunks["Chunked uploads<br/>[dropzone.ts]"]
  node_s3["S3 multipart"]
end

subgraph group_web["Project web presence"]
  node_docs["Documentation"]
  node_site["Product website"]
end

node_user(("Uploader"))

node_user -->|"drops files"| node_element
node_element -->|"initializes"| node_instance
node_instance -->|"uses defaults"| node_options
node_instance -->|"merges options"| node_extend
node_instance -->|"accepts files"| node_intake
node_intake -.->|"checks files"| node_validation
node_intake -.->|"queues files"| node_queue
node_instance -.->|"renders previews"| node_preview
node_instance -->|"creates thumbnails"| node_image
node_queue -.->|"processes files"| node_upload
node_upload -->|"sends request"| node_xhr
node_xhr -->|"uploads via XHR"| node_server
node_upload -.->|"supports chunking"| node_chunks
node_upload -.->|"supports multipart"| node_s3
node_instance -->|"emits events"| node_events
node_user -->|"consults"| node_docs
node_user -.->|"visits"| node_site

click node_instance "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_options "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/options.ts"
click node_extend "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/extend.ts"
click node_intake "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_validation "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_queue "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_preview "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/options.ts"
click node_image "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_upload "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_xhr "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_chunks "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts"
click node_s3 "https://github.com/enyo/dropzone/tree/main/packages/dropzone"
click node_events "https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/emitter.ts"
click node_docs "https://github.com/enyo/dropzone/tree/main/apps/docs"
click node_site "https://github.com/enyo/dropzone/tree/main/apps/website"

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_element,node_instance,node_options,node_extend,node_intake,node_validation,node_queue,node_preview,node_image,node_upload,node_events toneBlue
class node_xhr,node_server,node_chunks,node_s3 toneAmber
class node_docs,node_site toneMint
class node_user toneIndigo
```

## Components

### Upload runtime

- **Dropzone element**
- [Dropzone instance](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- [Configuration](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/options.ts): `packages/dropzone/src/options.ts`
- [Option merging](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/extend.ts): `packages/dropzone/src/extend.ts`
- [File intake](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- [File validation](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- [Upload queue](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- [File previews](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/options.ts): `packages/dropzone/src/options.ts`
- [Image processing](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- [Upload dispatch](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- [Event API](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/emitter.ts): `packages/dropzone/src/emitter.ts`

### Upload integrations

- [XHR transport](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- **Upload server**
- [Chunked uploads](https://github.com/enyo/dropzone/blob/main/packages/dropzone/src/dropzone.ts): `packages/dropzone/src/dropzone.ts`
- [S3 multipart](https://github.com/enyo/dropzone/tree/main/packages/dropzone): `packages/dropzone`

### Project web presence

- [Documentation](https://github.com/enyo/dropzone/tree/main/apps/docs): `apps/docs`
- [Product website](https://github.com/enyo/dropzone/tree/main/apps/website): `apps/website`

### Other components

- **Uploader**

## Connections

- Uploader → Dropzone element: drops files (evidence: `README.md`)
- Dropzone element → Dropzone instance: initializes (evidence: `README.md`)
- Dropzone instance → Configuration: uses defaults (evidence: `packages/dropzone/src/dropzone.ts`)
- Dropzone instance → Option merging: merges options (evidence: `packages/dropzone/src/dropzone.ts`)
- Dropzone instance → File intake: accepts files (evidence: `packages/dropzone/src/dropzone.ts`)
- File intake → File validation: checks files (evidence: `packages/dropzone/src/dropzone.ts`)
- File intake → Upload queue: queues files (evidence: `packages/dropzone/src/dropzone.ts`)
- Dropzone instance → File previews: renders previews (evidence: `packages/dropzone/src/dropzone.ts`)
- Dropzone instance → Image processing: creates thumbnails (evidence: `packages/dropzone/src/dropzone.ts`)
- Upload queue → Upload dispatch: processes files (evidence: `packages/dropzone/src/dropzone.ts`)
- Upload dispatch → XHR transport: sends request (evidence: `packages/dropzone/src/dropzone.ts`)
- XHR transport → Upload server: uploads via XHR (evidence: `README.md`)
- Upload dispatch → Chunked uploads: supports chunking (evidence: `packages/dropzone/src/dropzone.ts`)
- Upload dispatch → S3 multipart: supports multipart (evidence: `packages/dropzone/src/dropzone.ts`)
- Dropzone instance → Event API: emits events (evidence: `packages/dropzone/src/dropzone.ts`)
- Uploader → Documentation: consults (evidence: `README.md`)
- Uploader → Product website: visits
