autopilot_api 2.0.0

Zero dependency pure Dart API engine for Flutter with smart caching, retry, token refresh, multipart upload, download support and automatic parsing.

🚀 AutoPilot API Zero-boilerplate smart API engine for Flutter — now Pure Dart ⚡

Pure Dart • Zero Dependencies • No Dio • No http • No shared_preferences • Production Ready

🎯 Why AutoPilot?

Every Flutter project eventually faces the same problem:

repeated API boilerplate manual token handling retry logic everywhere duplicated error handling complex multipart uploads cache management headaches

AutoPilot solves all of this with a clean, beginner-friendly, production-ready API engine.

⚡ Why AutoPilot Is Different

Most API packages:

require heavy setup depend on multiple plugins force repository patterns need manual retry/cache/token handling become difficult for beginners

AutoPilot provides everything out of the box.

✅ Zero dependencies ✅ Pure Dart networking ✅ Automatic token injection ✅ Built-in retry system ✅ Smart caching ✅ Multipart uploads ✅ Auto parsing ✅ Request deduplication ✅ Production-ready architecture

❌ Traditional API Code Future<UserModel?> getUser() async { try { final request = await HttpClient() .getUrl(Uri.parse('$baseUrl/user'));

final response = await request.close();

if (response.statusCode == 200) {
  final body = await response
      .transform(utf8.decoder)
      .join();

  final json = jsonDecode(body);

  return UserModel.fromJson(json['data']);
}

} catch (e) { rethrow; }

return null; } ✅ AutoPilot Way final res = await api.get

if (res.isSuccess) { print(res.data); } else { print(res.message); } ✨ Features Feature Supported 🚀 GET, POST, PUT, PATCH, DELETE ✅ 📁 Multipart upload ✅ ⬇️ File download ✅ 🔐 Auto token injection ✅ 🔄 Auto token refresh ✅ 💾 Smart memory cache ✅ ⚡ Request deduplication ✅ 🔁 Retry with exponential backoff ✅ 🌐 Internet connectivity check ✅ 📦 Smart response parsing ✅ 🎨 Beautiful debug logs ✅ 🌍 Runtime environment switching ✅ 🔌 GetX / Bloc / Riverpod / Provider ✅ 🧪 Unit-test friendly ✅ ⚡ Zero dependencies ✅ 🔥 What's New in v2.0.0

AutoPilot is now built entirely using Dart SDK libraries.

No external networking package required.

❌ Removed External Packages Removed Package Replaced With http dart:io HttpClient shared_preferences Pure Dart local storage connectivity_plus Native socket lookup path Internal utilities mime Internal MIME resolver ⚡ Zero Dependencies dependencies: autopilot_api: ^2.0.0

That’s it.

No dependency conflicts. No platform channels. No native setup. No plugin headaches.

📦 Installation

Add this to your pubspec.yaml:

dependencies: autopilot_api: ^2.0.0

Then run:

flutter pub get 🚀 60-Second Integration Step 1 — Initialize AutoPilot void main() async { WidgetsFlutterBinding.ensureInitialized();

await AutoPilotApi.init( baseUrl : 'https://api.example.com/v1', enableLogs : true, enableCache : true, );

runApp(const MyApp()); } Step 2 — Make Your First API Call final api = AutoPilotApi.instance;

final res = await api.get

if (res.isSuccess) { print(res.data); } else { print(res.message); }

That’s enough to start using AutoPilot in any Flutter project.

📚 Complete Beginner Flow Step 1 — Create Model class UserModel { final int id; final String name;

UserModel({ required this.id, required this.name, });

factory UserModel.fromJson(Map<String, dynamic> json) { return UserModel( id : json['id'], name : json['name'], ); } } Step 2 — Call API final res = await api.get

AutoPilot uses:

import 'dart:io';

Powered internally by:

HttpClient

No http package required.

🔐 Token Management Save Access Token await AutoPilotApi.setToken(token); Save Access + Refresh Tokens await AutoPilotApi.setTokens( accessToken : accessToken, refreshToken : refreshToken, ); Logout await AutoPilotApi.clearTokens();

Tokens are stored using:

⚡ In-memory cache 💾 Pure Dart local storage 🔄 Auto Token Refresh await AutoPilotApi.init( enableTokenRefresh : true,

onRefreshToken : () async { final token = await refreshAuthToken(); return token; }, ); Refresh Flow Request ↓ 401 Unauthorized ↓ Refresh Token ↓ Retry Original Request ↓ Success ✅ 💾 Smart Cache final res = await api.get( endpoint : '/config', useCache : true, cacheDuration : Duration(hours: 1), );

Supports:

⚡ Memory cache 💽 Persistent disk cache 🧠 Automatic invalidation 🔑 Smart cache keys 📁 Multipart Upload final res = await api.multipart( endpoint : '/upload',

files : [ MultipartFileModel( key : 'image', path : file.path, ), ], );

Supports:

Single file upload Multiple files Videos PDFs Form-data fields Custom MIME types ⬇️ File Download final res = await api.download( endpoint : '/invoice.pdf', savePath : '/storage/downloads/invoice.pdf',

onProgress : (received, total) { final progress = received / total; print(progress); }, ); ⚡ Request Deduplication await Future.wait([ api.get(endpoint: '/user'), api.get(endpoint: '/user'), api.get(endpoint: '/user'), ]);

✅ Only ONE request hits the server.

All callers receive the same response.

🔁 Retry System await AutoPilotApi.init( maxRetries : 3, retryDelay : Duration(seconds: 1), ); Retry Flow Attempt 1 → Fail Attempt 2 → Fail Attempt 3 → Success ✅

Retries automatically on:

SocketException TimeoutException Temporary connection failures 🎨 Beautiful Debug Logs ┌───────────────────────────────────────────── │ 🚀 REQUEST [REQ-9A1F] │ GET https://api.example.com/user └─────────────────────────────────────────────

┌───────────────────────────────────────────── │ ✅ RESPONSE [REQ-9A1F] │ Status: 200 │ Time: 221ms └───────────────────────────────────────────── 📦 ApiResponse

Every request returns a strongly typed response object:

ApiResponse

✅ GetX ✅ Bloc ✅ Cubit ✅ Riverpod ✅ Provider ✅ MobX ✅ Vanilla setState

No adapters or wrappers required.

🌍 Runtime Environment Switching api.reconfigure( (config) => config.copyWith( baseUrl: 'https://staging.api.com', ), );

Perfect for:

staging production testing QA environments 🧪 Unit Testing Friendly flutter test

Supports:

Mock clients Fake responses Offline testing Parser testing 📐 Performance Optimized ⚡ Fast because: Persistent HttpClient In-memory token cache Request deduplication Smart retries Minimal allocations Zero reflection No platform channels 🛡 Built-in Exceptions ApiException NetworkException TimeoutApiException UnauthorizedException ValidationException ServerException CacheException 📋 API Reference Method Description get() GET request post() POST request put() PUT request patch() PATCH request delete() DELETE request multipart() Upload files download() Download files clearCache() Clear all cache invalidateCache() Remove endpoint cache setToken() Save access token clearTokens() Logout reconfigure() Runtime config update 🔥 Perfect For Flutter beginners Production apps MVPs Admin panels E-commerce apps REST APIs Clean architecture projects GetX / Riverpod / Bloc apps ⚡ Performance Comparison Feature Traditional APIs AutoPilot Boilerplate High Very Low Dependencies Multiple Zero Retry Manual Built-in Token Refresh Manual Automatic Cache Manual Built-in Multipart Upload Complex Simple Setup Time Long Minutes 🎯 Why Developers Love AutoPilot

✅ Minimal boilerplate ✅ Faster development ✅ Production-ready architecture ✅ Beginner-friendly API ✅ Zero dependency conflicts ✅ Smaller APK size ✅ Faster compile times ✅ Pure Dart performance

📄 License

MIT License © 2026 AutoPilot API

Made with ❤️ for Flutter developers

⭐ Star on GitHub • 📦 Publish on pub.dev • 🚀 Build faster with AutoPilot