本文へ移動
cccskills
無料GitHub で公開

flutter-retrofit-networking

Build type-safe HTTP networking with Dio and Retrofit including auth interceptors in Flutter. Use when integrating REST APIs with Dio or Retrofit.

インストール方法を見る

含まれるファイル(5)

  • SKILL.md2.2 KB
  • evals/evals.json1.9 KB
  • references/implementation.md672 B
  • references/REFERENCE.md830 B
  • references/token-refresh.md1.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Retrofit & Dio Networking

Priority: P0 (CRITICAL)

Structure

infrastructure/
├── data_sources/
│   ├── remote/       # Retrofit abstract classes
│   └── local/        # Cache/Storage
└── network/
    ├── dio_client.dart    # Custom Dio setup
    └── interceptors/      # Auth, Logging, Cache

Implementation Workflow

  1. Define Retrofit clients — Create abstract classes with @RestApi() and HTTP annotations (@GET, @POST). Methods return Future<DTO>.
  2. Create DTOs — Use @freezed and @JsonSerializable for all request/response bodies.
  3. Map to domain — Data sources must map DTOs to Domain Entities (e.g., userDto.toDomain()).
  4. Guard enums — Always use @JsonKey(unknownEnumValue: Status.unknown) to prevent crashes from new backend values.
  5. Add auth interceptor — Inject Authorization: Bearer <token> in onRequest.
  6. Handle token refresh — On 401, lock Dio, call refreshToken(), update stored token, retry via dio.fetch(err.requestOptions).
  7. Map failures — Convert DioException to typed Failure objects (ServerFailure, NetworkFailure).

Retrofit Client & Safe Enum DTO Examples

See implementation examples for RestClient definitions and safe enum DTO patterns.

Anti-Patterns

  • No Manual JSON Parsing: Use Retrofit's generated mappers instead of jsonDecode
  • No Global Dio Instances: Inject Dio through DI
  • No Inline Try-Catch: repository layer should handle all Retrofit exceptions
  • No Unguarded Enums: Always include unknownEnumValue to prevent crashes on new backend values

Reference & Examples

For RestClient definitions and Auth Interceptor implementation: See references/REFERENCE.md.

Related Topics

feature-based-clean-architecture | error-handling

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Upgrade an Android project to Android Gradle Plugin (AGP) 9. Use when migrating to AGP 9, updating Gradle build files, migrating to built-in Kotlin, or adopting the new AGP DSL.

日本語の概要は準備中です。原文の説明を表示しています。

HoangNguyen0403/agent-skills-standard5732026年10月12日 更新

Apply Clean Architecture layering, modularization, and Unidirectional Data Flow in Android projects. Use when setting up project structure, placing code in layers, configuring feature/core modules, or implementing UDF patterns; defer Compose state and ViewModel/StateFlow implementation to their specific skills.

日本語の概要は準備中です。原文の説明を表示しています。

HoangNguyen0403/agent-skills-standard5732026年10月12日 更新

Implement WorkManager and background processing correctly on Android. Use when creating Worker classes, scheduling tasks, choosing between WorkManager and Foreground Services, or setting up Hilt in workers; defer FCM and notification delivery to android-notifications.

日本語の概要は準備中です。原文の説明を表示しています。

HoangNguyen0403/agent-skills-standard5732026年10月12日 更新

Build high-performance declarative UI with Jetpack Compose. Use when writing Composable functions, optimizing recomposition, hoisting state, or working with LazyColumn and side effects; defer deep-link and navigation routing to android-navigation.

日本語の概要は準備中です。原文の説明を表示しています。

HoangNguyen0403/agent-skills-standard5732026年10月12日 更新

Migrate an Android XML View to Jetpack Compose following a structured 10-step workflow. Use when converting XML layouts to Compose, setting up Compose in an existing View-based project, or incrementally adopting Compose.

日本語の概要は準備中です。原文の説明を表示しています。

HoangNguyen0403/agent-skills-standard5732026年10月12日 更新

Write correct coroutine scopes, lifecycle collection, and dispatcher injection in Android production code. Use for suspend functions, coroutine scopes, and dispatcher mechanics; defer ViewModel StateFlow/LiveData architecture, Fragment lifecycle recipes, persistence/notifications, and unit-test recipes to their specific skills.

日本語の概要は準備中です。原文の説明を表示しています。

HoangNguyen0403/agent-skills-standard5732026年10月12日 更新

HoangNguyen0403 のスキルをすべて見る

このスキルの問題を報告する