skydoves/sandwich

Health v2 · maintenance only

Adoption not part of the score

1770 stars · 113 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Sandwich is a lightweight Kotlin library that provides sealed ApiResponse types for modeling and handling API responses and exceptions from Retrofit, Ktor, and Ktorfit. It offers functional operators, mappers, and global response handling so developers can avoid writing custom Resource/Result wrapper classes.

Use cases

• handle retrofit api responses and errors in kotlin
• avoid writing resource wrapper classes for network calls
• handle network exceptions elegantly in android apps
• standardize api response handling across kotlin multiplatform projects
• apply global operators to all network responses
• map api error responses to custom models
• test network response handling with fake factories

When to choose

• you use Retrofit, Ktor, or Ktorfit in Kotlin and want consistent response/error handling
• you're tired of writing boilerplate Resource or Result wrapper classes
• you want functional operators and mappers for network responses
• you need shared network response handling in Kotlin Multiplatform
• you want global response handling across your app

When to avoid

• you don't use Retrofit, Ktor, or Ktorfit for networking
• your project already has an established response-handling pattern
• you need a full networking client rather than a response-handling layer
• you're not using Kotlin

Facets

library · maturity stable

http-client error-handling serialization android-tools web-development developer-tools jvm cross-platform retrofit ktor kotlin-multiplatform api-response-handling sealed-classes coroutines android

Member repositories

For agents

markdown · JSON · MCP: product_card(name="skydoves/sandwich")