lysine-dev/retrofit
A type-safe HTTP client for Android and the JVM
How retrofit is put together
Retrofit is a type-safe HTTP client library for Android and Java (com.squareup.retrofit2), written primarily in Java with Kotlin extensions. Users declare service interfaces annotated with @GET/@POST/@Query etc.; Retrofit turns these into OkHttp requests at runtime via reflection (RequestFactory/ServiceMethod), executes them through an OkHttp Call, and converts responses back to declared types via pluggable Converter and CallAdapter factories. The core 'retrofit' module is published as a multi-release JAR (Java 8 base plus java14/java16 variants) and is accompanied by optional adapter modules (RxJava, Guava, CompletableFuture) and converter modules (Gson, Moshi, Jackson, Protobuf, Wire, etc.), all aggregated in a BOM.
Languages
Frameworks
Infrastructure
Major components
retrofit (core)
Core library that parses annotated service interfaces, builds OkHttp requests, executes calls, and adapts/converts responses.
retrofit2.http annotations
Defines the HTTP method and parameter annotations (@GET, @POST, @Path, @Query, @Header, @Body, etc.) users apply to interface methods.
Converter framework
Pluggable serialization layer (Converter.Factory, BuiltInConverters, OptionalConverterFactory) turning RequestBody/ResponseBody to/from Java types.
CallAdapter framework
Pluggable adaptation of Call<T> to other return types (DefaultCallAdapterFactory, CompletableFutureCallAdapterFactory).
Platform abstraction
Detects runtime platform (Android vs JVM vs Java 8+) to select callback executors like AndroidMainExecutor and built-in factories (BuiltInFactories, Platform, Reflection, DefaultMethodSupport).
retrofit-adapters
Optional modules adapting calls to RxJava/RxJava2/RxJava3, Guava ListenableFuture, Java 8 CompletableFuture, and Scala types.
retrofit-converters
Optional serialization modules for Gson, Moshi, Jackson, kotlinx-serialization, Protobuf, Wire, SimpleXML, JAXB/JAXB3, Guava, Java 8 Optional, and scalars.
retrofit-mock & test tooling
MockRetrofit/NetworkBehavior for simulating calls, plus test-helpers, android-test, robovm-test, and the retrofit-response-type-keeper annotation processor.
A heavy maintenance week with nearly 40 automated updates to dependencies, build tools, and CI workflows, plus adoption of a shared Renovate config.
The past two weeks on the retrofit repository were dominated by maintenance work. The most recent week was a large housekeeping push: dozens of automated dependency and tooling updates across the build system, testing libraries, and CI workflows, plus a switch to a shared Renovate configuration. The prior week was much quieter, focused on documentation with a new contributing guide and a small workflow fix.
Week by week
2026-08-17A heavy maintenance week with nearly 40 automated updates to dependencies, build tools, and CI workflows, plus adoption of a shared Renovate config.latest6 changes
Chore
Shared Renovate config
The project now uses a common automated dependency-update configuration so future upgrades are handled consistently.
Chore
Core toolchain upgrades
Kotlin was bumped to 2.4.10, Gradle to 9.7.1, OkHttp to 5.5.0, and Java to 26, keeping the project on current platform versions.
Chore
Library refresh
Many supporting libraries were updated, including Jackson 2.22.2, Gson 2.14.0, Guava 33.7.1, coroutines 1.11.0, kotlinx.serialization 1.11.0, and Protobuf 3.25.9.
Chore
CI action updates
GitHub Actions used for checkout, Java setup, artifact handling, releases, and Android emulator runs were all upgraded to newer versions.
Chore
Website publishing improvements
The docs site pipeline switched to npm ci for reliable installs, gained mode-specific environment files for site URLs, and moved to version 4 of the GitHub Pages deploy action.
Fix
Publish job permissions
The release-publishing workflow was granted write permissions so it can complete successfully.
2026-08-10A quiet week focused on documentation and a small workflow correction.2 changes
Docs
New contributing guide
A new document was added explaining how outside contributors can get involved with the project.
Fix
Build workflow condition fix
The continuous-integration workflow conditions were updated to reference the lysine-dev organization so builds trigger correctly.
Dependencies and code review
Dependency advisories
Security Watch
No known advisories across 0 scanned dependencies.
No known advisories in the scanned dependencies.
Code review
No concrete code-level issues confirmed.
Get this report every week for your repos.
GitZoid learns each repo, reports what changed, and flags what needs attention. One flat price for the whole team.
$19 a month, flat · First 10 outputs free · No card required