dio_cache_interceptor — Flutter Production Skill

Purpose

Use this skill to make endpoint-specific, evidence-based decisions about dio_cache_interceptor. Optimize correctness and isolation before hit rate. Inspect the repository's existing Dio, authentication, persistence, dependency-injection, and testing conventions before adding an abstraction or dependency.

Research Basis

• Research date: 2026-09-02.
• Target: dio_cache_interceptor 4.0.7, Dart SDK constraint ^3.8.0, Dio ^5.2.0+1, and http_cache_core ^1.1.4 in the published archive.
• Reviewed: current pub.dev readme, API docs, example, versions and changelog; the maintainer-linked llfbandit/dart_http_cache repository; the exact 4.0.7 pub archive; core strategy/interceptor/store source and official tests; first-party store pages and source.
• Documentation gaps: the package does not publish performance numbers, cache-size recommendations for persistent stores, a complete interceptor-order contract, request coalescing, encryption key management, or an offline-first synchronization model. Measure and design these in the application.
• Verified package behavior is labeled Package. Standards context is HTTP. Advice derived for production is Recommendation.
• Known discrepancies: the main readme calls Isar available on all platforms, while the current http_cache_isar_store package metadata excludes web. The main readme calls MMKV iOS/Android-only, while its package metadata also advertises desktop. Treat Isar as non-web and MMKV as mobile-only until the chosen versions are validated on every target. The file-store package is listed for web by pub.dev metadata, but its web implementation is a no-op.

When to Use This Skill

Use it when a task involves: