# pingdotgg/uploadthing architecture

> Architecture diagram of the GitHub repository pingdotgg/uploadthing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pingdotgg/uploadthing
- Repository: https://github.com/pingdotgg/uploadthing

## Overview

##### Main Components

a) Core Components:
- UploadThing Server (Core Engine)
- File Storage Service
- Authentication Layer
- Framework-specific Adapters

b) Client SDKs:
- React (@uploadthing/react)
- Solid (@uploadthing/solid)
- Vue (@uploadthing/vue)
- Svelte (@uploadthing/svelte)
- Expo (@uploadthing/expo)
- Nuxt Integration

##### Architecture Representation

**┌─ Client Layer ──────────────────────────────────────┐**
- React │ Solid │ Vue │ Svelte │ Expo │ Nuxt         │
- Integration Layer ─────────────────────────────────┤
- Framework Adapters                                  │
- (Next.js, Express, Fastify, H3, etc.)              │
- Core Service Layer ─────────────────────────────────┤
- UploadThing Core                                    │
- File Processing                                   │
- Validation                                        │
- Route Configuration                               │
- Error Handling                                    │
- Infrastructure Layer ──────────────────────────────┤
- File Storage │ Authentication │ Security            │
- ┘

##### Special Features

- Middleware handling
- File type validation
- Error handling paths
- Authentication flow
- Framework-specific optimizations

##### Implementation Details

- How different frameworks connect to the core
- File upload lifecycle
- Error propagation paths
- Authentication integration points
- Storage service interaction

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client["Client Layer"]
        direction TB
        React["React SDK"]:::client
        Solid["Solid SDK"]:::client
        Vue["Vue SDK"]:::client
        Svelte["Svelte SDK"]:::client
        Expo["Expo SDK"]:::client
        Nuxt["Nuxt SDK"]:::client
    end

    subgraph Integration["Integration Layer"]
        direction TB
        Next["Next.js Adapter"]:::adapter
        Express["Express Adapter"]:::adapter
        Fastify["Fastify Adapter"]:::adapter
        H3["H3 Adapter"]:::adapter
        Remix["Remix Adapter"]:::adapter
    end

    subgraph Core["Core Service Layer"]
        direction TB
        Handler["Core Handler"]:::core
        RouteConfig["Route Configuration"]:::core
        Runtime["Runtime"]:::core
        FileProcessing["File Processing"]:::core
        Validation["Validation"]:::core
        ErrorHandling["Error Handling"]:::core
    end

    subgraph Infrastructure["Infrastructure Layer"]
        direction TB
        Storage["File Storage"]:::infra
        Auth["Authentication"]:::infra
        Security["Security"]:::infra
    end

    subgraph Shared["Shared Components"]
        direction TB
        Types["Common Types"]:::shared
        Errors["Error Utils"]:::shared
        FileTypes["File Types"]:::shared
        Crypto["Crypto Utils"]:::shared
        MIME["MIME Types"]:::shared
    end

    %% Client to Integration connections
    React --> Next
    Solid --> Next
    Vue --> Express
    Svelte --> Fastify
    Expo --> H3
    Nuxt --> H3

    %% Integration to Core connections
    Next --> Handler
    Express --> Handler
    Fastify --> Handler
    H3 --> Handler
    Remix --> Handler

    %% Core internal connections
    Handler --> RouteConfig
    Handler --> Runtime
    Handler --> FileProcessing
    Handler --> Validation
    Handler --> ErrorHandling

    %% Core to Infrastructure connections
    FileProcessing --> Storage
    Validation --> Auth
    Runtime --> Security

    %% Shared utilities connections
    Types --> Handler
    Errors --> ErrorHandling
    FileTypes --> Validation
    Crypto --> Security
    MIME --> FileProcessing

    %% Click events for component mapping
    click React "https://github.com/pingdotgg/uploadthing/tree/main/packages/react/src"
    click Solid "https://github.com/pingdotgg/uploadthing/tree/main/packages/solid/src"
    click Vue "https://github.com/pingdotgg/uploadthing/tree/main/packages/vue/src"
    click Svelte "https://github.com/pingdotgg/uploadthing/tree/main/packages/svelte/src"
    click Expo "https://github.com/pingdotgg/uploadthing/tree/main/packages/expo/src"
    click Nuxt "https://github.com/pingdotgg/uploadthing/tree/main/packages/nuxt/src"
    click Next "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/next.ts"
    click Express "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/express.ts"
    click Fastify "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/fastify.ts"
    click H3 "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/h3.ts"
    click Remix "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/remix.ts"
    click Handler "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/internal/handler.ts"
    click RouteConfig "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/internal/route-config.ts"
    click Runtime "https://github.com/pingdotgg/uploadthing/blob/main/packages/uploadthing/src/internal/runtime.ts"
    click Types "https://github.com/pingdotgg/uploadthing/blob/main/packages/shared/src/types.ts"
    click Errors "https://github.com/pingdotgg/uploadthing/blob/main/packages/shared/src/error.ts"
    click FileTypes "https://github.com/pingdotgg/uploadthing/blob/main/packages/shared/src/file-types.ts"
    click Crypto "https://github.com/pingdotgg/uploadthing/blob/main/packages/shared/src/crypto.ts"
    click MIME "https://github.com/pingdotgg/uploadthing/tree/main/packages/mime-types/src"

    classDef client fill:#3498db,stroke:#2980b9,color:white
    classDef adapter fill:#f1c40f,stroke:#f39c12,color:black
    classDef core fill:#2ecc71,stroke:#27ae60,color:white
    classDef infra fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef shared fill:#e74c3c,stroke:#c0392b,color:white
```
