dio_retry_interceptor

A custom Dio interceptor for Flutter/Dart that automatically retries HTTP requests when network connectivity is restored. Ideal for handling flaky or slow network conditions.

✨ Features

✅ Retries failed requests on connection error or timeout
🔁 Supports configurable retry attempts
🔌 Checks connectivity before retrying
🛠️ Toggle retry for POST/PUT requests
🐞 Optional debug logs for retry attempts

🚀 Getting Started

Installation

Add this to your pubspec.yaml:

dependencies:
  dio_retry_interceptor: ^<latest_version>

Then run:

flutter pub get

Usage

import 'package:dio/dio.dart';
import 'package:dio_retry_interceptor/dio_retry_interceptor.dart';

...

final dio = Dio();

dio.interceptors.add(
  RetryOnConnectionChangeInterceptor(
    dio,
    maxRetryAttempts: 3,
    retryPost: false,
    enableLogging: true,
  ),
);

Optionally Mark a Request as Retryable (for non-GET)
await dio.post(
  '/your-api',
  data: {...},
  options: Options(
    extra: {'retryable': true},
  ),
);

Option	Description	Default
`maxRetryAttempts`	Max number of retry attempts per request	`3`
`retryPost`	Allow retry for POST/PUT requests	`false`
`enableLogging`	Show console logs for each retry attempt	`false`

Contributors

Feel free to open issues or submit PRs to improve this package.