# cfug/dio architecture

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

- Interactive diagram: https://gitdiagram.com/cfug/dio
- Repository: https://github.com/cfug/dio

## Overview

This is the Dio Dart HTTP-client workspace: applications issue configured requests and receive responses, with platform adapters, interception, transformation, cancellation, and multipart support. The README also identifies separate cookie, compatibility, HTTP/2, native, and web adapter packages. The source excerpts are Flutter example runners rather than Dio runtime code, so runtime relationships below are dashed and unverified; paths identify implementations from the tree, not inspected behavior.

Main entry points: [`dio/lib/src/dio_mixin.dart`](https://github.com/cfug/dio/blob/main/dio/lib/src/dio_mixin.dart) (Request engine), [`dio/lib/src/interceptor.dart`](https://github.com/cfug/dio/blob/main/dio/lib/src/interceptor.dart) (Interceptors), [`dio/lib/src/adapter.dart`](https://github.com/cfug/dio/blob/main/dio/lib/src/adapter.dart) (Adapter API), [`dio/lib/src/form_data.dart`](https://github.com/cfug/dio/blob/main/dio/lib/src/form_data.dart) (Form data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["HTTP Client"]
  node_dio["Dio API"]
  node_mixin["Request engine<br/>[dio_mixin.dart]"]
  node_options["Request options<br/>[options.dart]"]
  node_cancel["Cancellation<br/>[cancel_token.dart]"]
  node_response["Response<br/>[response.dart]"]
end

subgraph group_processing["Request Processing"]
  node_interceptors["Interceptors<br/>[interceptor.dart]"]
  node_contenttype["Content type"]
  node_logging["Logging<br/>[log.dart]"]
  node_formdata["Form data<br/>[form_data.dart]"]
  node_multipart["Multipart files"]
  node_transformer["Transformer API<br/>[transformer.dart]"]
  node_background["Background transform"]
end

subgraph group_transport["Transport"]
  node_adapter["Adapter API<br/>[adapter.dart]"]
  node_ioadapter["Native adapter<br/>[io_adapter.dart]"]
  node_browseradapter["Browser adapter"]
end

subgraph group_extensions["Plugin Packages"]
  node_cookies["Cookie manager<br/>[cookie_mgr.dart]"]
  node_compat["Compatibility layer"]
  node_http2["HTTP/2 adapter<br/>[http2_adapter.dart]"]
  node_nativeplugin["Native adapter plugin"]
  node_webplugin["Web adapter plugin"]
end

node_app(("Dart application"))
node_http(("HTTP service"))

node_app -.->|"issues request"| node_dio
node_dio -.->|"delegates to"| node_mixin
node_mixin -.->|"uses options"| node_options
node_mixin -.->|"checks cancellation"| node_cancel
node_mixin -.->|"dispatches through"| node_interceptors
node_interceptors -.->|"may apply"| node_contenttype
node_interceptors -.->|"may apply"| node_logging
node_mixin -.->|"encodes form"| node_formdata
node_formdata -.->|"contains files"| node_multipart
node_mixin -.->|"transforms data"| node_transformer
node_transformer -.->|"may use"| node_background
node_mixin -.->|"dispatches request"| node_adapter
node_adapter -.->|"implemented by"| node_ioadapter
node_adapter -.->|"implemented by"| node_browseradapter
node_ioadapter -.->|"sends HTTP"| node_http
node_browseradapter -.->|"sends HTTP"| node_http
node_mixin -.->|"returns response"| node_response
node_cookies -.->|"extends client"| node_dio
node_compat -.->|"adapts client"| node_dio
node_http2 -.->|"provides adapter"| node_dio
node_nativeplugin -.->|"provides adapter"| node_dio
node_webplugin -.->|"provides adapter"| node_dio

click node_mixin "https://github.com/cfug/dio/blob/main/dio/lib/src/dio_mixin.dart"
click node_options "https://github.com/cfug/dio/blob/main/dio/lib/src/options.dart"
click node_cancel "https://github.com/cfug/dio/blob/main/dio/lib/src/cancel_token.dart"
click node_interceptors "https://github.com/cfug/dio/blob/main/dio/lib/src/interceptor.dart"
click node_contenttype "https://github.com/cfug/dio/blob/main/dio/lib/src/interceptors/imply_content_type.dart"
click node_logging "https://github.com/cfug/dio/blob/main/dio/lib/src/interceptors/log.dart"
click node_formdata "https://github.com/cfug/dio/blob/main/dio/lib/src/form_data.dart"
click node_multipart "https://github.com/cfug/dio/blob/main/dio/lib/src/multipart_file.dart"
click node_transformer "https://github.com/cfug/dio/blob/main/dio/lib/src/transformer.dart"
click node_background "https://github.com/cfug/dio/blob/main/dio/lib/src/transformers/background_transformer.dart"
click node_response "https://github.com/cfug/dio/blob/main/dio/lib/src/response.dart"
click node_adapter "https://github.com/cfug/dio/blob/main/dio/lib/src/adapter.dart"
click node_ioadapter "https://github.com/cfug/dio/blob/main/dio/lib/src/adapters/io_adapter.dart"
click node_browseradapter "https://github.com/cfug/dio/blob/main/dio/lib/src/adapters/browser_adapter.dart"
click node_cookies "https://github.com/cfug/dio/blob/main/plugins/cookie_manager/lib/src/cookie_mgr.dart"
click node_compat "https://github.com/cfug/dio/blob/main/plugins/compatibility_layer/lib/src/conversion_layer_adapter.dart"
click node_http2 "https://github.com/cfug/dio/blob/main/plugins/http2_adapter/lib/src/http2_adapter.dart"
click node_nativeplugin "https://github.com/cfug/dio/tree/main/plugins/native_dio_adapter/lib"
click node_webplugin "https://github.com/cfug/dio/tree/main/plugins/web_adapter/lib/src"

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_dio,node_mixin,node_options,node_cancel,node_response toneBlue
class node_interceptors,node_contenttype,node_logging,node_formdata,node_multipart,node_transformer,node_background toneAmber
class node_adapter,node_ioadapter,node_browseradapter toneMint
class node_cookies,node_compat,node_http2,node_nativeplugin,node_webplugin toneRose
class node_app,node_http toneIndigo
```

## Components

### HTTP Client

- **Dio API**
- [Request engine](https://github.com/cfug/dio/blob/main/dio/lib/src/dio_mixin.dart): `dio/lib/src/dio_mixin.dart`
- [Request options](https://github.com/cfug/dio/blob/main/dio/lib/src/options.dart): `dio/lib/src/options.dart`
- [Cancellation](https://github.com/cfug/dio/blob/main/dio/lib/src/cancel_token.dart): `dio/lib/src/cancel_token.dart`
- [Response](https://github.com/cfug/dio/blob/main/dio/lib/src/response.dart): `dio/lib/src/response.dart`

### Request Processing

- [Interceptors](https://github.com/cfug/dio/blob/main/dio/lib/src/interceptor.dart): `dio/lib/src/interceptor.dart`
- [Content type](https://github.com/cfug/dio/blob/main/dio/lib/src/interceptors/imply_content_type.dart): `dio/lib/src/interceptors/imply_content_type.dart`
- [Logging](https://github.com/cfug/dio/blob/main/dio/lib/src/interceptors/log.dart): `dio/lib/src/interceptors/log.dart`
- [Form data](https://github.com/cfug/dio/blob/main/dio/lib/src/form_data.dart): `dio/lib/src/form_data.dart`
- [Multipart files](https://github.com/cfug/dio/blob/main/dio/lib/src/multipart_file.dart): `dio/lib/src/multipart_file.dart`
- [Transformer API](https://github.com/cfug/dio/blob/main/dio/lib/src/transformer.dart): `dio/lib/src/transformer.dart`
- [Background transform](https://github.com/cfug/dio/blob/main/dio/lib/src/transformers/background_transformer.dart): `dio/lib/src/transformers/background_transformer.dart`

### Transport

- [Adapter API](https://github.com/cfug/dio/blob/main/dio/lib/src/adapter.dart): `dio/lib/src/adapter.dart`
- [Native adapter](https://github.com/cfug/dio/blob/main/dio/lib/src/adapters/io_adapter.dart): `dio/lib/src/adapters/io_adapter.dart`
- [Browser adapter](https://github.com/cfug/dio/blob/main/dio/lib/src/adapters/browser_adapter.dart): `dio/lib/src/adapters/browser_adapter.dart`

### Plugin Packages

- [Cookie manager](https://github.com/cfug/dio/blob/main/plugins/cookie_manager/lib/src/cookie_mgr.dart): `plugins/cookie_manager/lib/src/cookie_mgr.dart`
- [Compatibility layer](https://github.com/cfug/dio/blob/main/plugins/compatibility_layer/lib/src/conversion_layer_adapter.dart): `plugins/compatibility_layer/lib/src/conversion_layer_adapter.dart`
- [HTTP/2 adapter](https://github.com/cfug/dio/blob/main/plugins/http2_adapter/lib/src/http2_adapter.dart): `plugins/http2_adapter/lib/src/http2_adapter.dart`
- [Native adapter plugin](https://github.com/cfug/dio/tree/main/plugins/native_dio_adapter/lib): `plugins/native_dio_adapter/lib`
- [Web adapter plugin](https://github.com/cfug/dio/tree/main/plugins/web_adapter/lib/src): `plugins/web_adapter/lib/src`

### Other components

- **Dart application**
- **HTTP service**

## Connections

- Dart application → Dio API: issues request
- Dio API → Request engine: delegates to
- Request engine → Request options: uses options
- Request engine → Cancellation: checks cancellation
- Request engine → Interceptors: dispatches through
- Interceptors → Content type: may apply
- Interceptors → Logging: may apply
- Request engine → Form data: encodes form
- Form data → Multipart files: contains files
- Request engine → Transformer API: transforms data
- Transformer API → Background transform: may use
- Request engine → Adapter API: dispatches request
- Adapter API → Native adapter: implemented by
- Adapter API → Browser adapter: implemented by
- Native adapter → HTTP service: sends HTTP
- Browser adapter → HTTP service: sends HTTP
- Request engine → Response: returns response
- Cookie manager → Dio API: extends client
- Compatibility layer → Dio API: adapts client
- HTTP/2 adapter → Dio API: provides adapter
- Native adapter plugin → Dio API: provides adapter
- Web adapter plugin → Dio API: provides adapter
