cfug/dio

★ 12,813DartAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((Dio))
    Core features
      Interceptors
      Request cancellation
      Timeouts
    File handling
      Uploads
      Downloads
    Plugins
      Cookie manager
      HTTP2 support
      Native adapter
    Configuration
      Global settings
      Custom adapters
      Form data

mindmap root((Dio)) Core features Interceptors Request cancellation Timeouts File handling Uploads Downloads Plugins Cookie manager HTTP2 support Native adapter Configuration Global settings Custom adapters Form data

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Add a global authentication interceptor to a Flutter app so every API request automatically attaches a Bearer token.

USE CASE 2

Upload images or files from a mobile app to a server with progress tracking and cancellation support.

USE CASE 3

Fetch data from a REST API in a Flutter app with automatic timeout handling and retry logic.

USE CASE 4

Manage cookies across multiple requests in a Flutter app using the dio_cookie_manager plugin.

Tech stack

DartFlutter

Getting it running

Difficulty · easy Time to first run · 5min

Add dio to pubspec.yaml and import, no external services or configuration required.

MIT, use freely for any purpose including commercial, with no restrictions beyond keeping the copyright notice.

In plain English

Dio is an HTTP client library for Dart and Flutter, the programming language and mobile app framework made by Google. When a Flutter app needs to communicate with a server over the internet, such as fetching data from an API or uploading a file, it needs a tool to handle those network requests. Dio is that tool, and it adds a range of features on top of what Dart includes by default. The description lists what dio covers: global configuration that applies to every request your app makes, interceptors that can inspect or modify requests and responses before they reach your code, support for sending form data, the ability to cancel a request that is already in flight, file uploads and downloads, and timeout handling so requests that take too long do not hang forever. Developers can also swap in custom adapters if they need to change how the underlying connection is made, for example to use HTTP/2 or the device's native networking layer. The repository is organized as a monorepo, meaning the core library and several official plugins all live together in one place. Separate plugin packages handle cookie management, HTTP/2 support, a native adapter that uses the operating system's own network stack, and a web adapter for running in browsers. Each package is published independently to pub.dev, which is the standard package registry for Dart. The project was originally created by a developer named wendux and was later transferred to the Chinese Flutter User Group for ongoing maintenance. It is released under the MIT license. The root README is intentionally minimal and points readers toward the individual package directories for more detailed documentation.

Copy-paste prompts

Prompt 1

Using the Dio library in Flutter, write a Dart class that wraps Dio with a base URL, adds an auth token interceptor that reads from shared preferences, and handles 401 errors by refreshing the token.

Prompt 2

Show me how to use Dio in Flutter to upload a file with multipart/form-data, display upload progress to the user, and cancel the upload if the user navigates away.

Prompt 3

I'm using Dio in my Flutter app. Write error-handling middleware that catches network timeouts, server errors, and parsing errors and returns a typed Result object instead of throwing exceptions.

Prompt 4

How do I configure Dio to use the native iOS/Android networking stack instead of Dart's default HTTP client, and why would I want to do that?

Open on GitHub → Explain another repo

← cfug on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.