https://github.com/zacsweers/metro
A multiplatform, compile-time dependency injection framework for Kotlin
https://github.com/zacsweers/metro
compiler-plugin dependency-injection di jakarta-inject javax-inject jsr-330 kotlin
Last synced: about 2 months ago
JSON representation
A multiplatform, compile-time dependency injection framework for Kotlin
- Host: GitHub
- URL: https://github.com/zacsweers/metro
- Owner: ZacSweers
- License: apache-2.0
- Created: 2024-11-05T18:19:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-22T01:06:34.000Z (about 2 months ago)
- Last Synced: 2026-04-22T01:31:11.702Z (about 2 months ago)
- Topics: compiler-plugin, dependency-injection, di, jakarta-inject, javax-inject, jsr-330, kotlin
- Language: Kotlin
- Homepage: https://zacsweers.github.io/metro/
- Size: 31.4 MB
- Stars: 1,151
- Watchers: 11
- Forks: 93
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 🚇 Metro
A compile-time dependency injection framework for Kotlin Multiplatform, powered by a Kotlin compiler plugin.
[](https://github.com/ZacSweers/metro/releases)
[](docs/compatibility.md)
[](https://github.com/ZacSweers/metro/actions/workflows/ci.yml)
[](https://www.apache.org/licenses/LICENSE-2.0)
---
## What is Metro?
Metro is a compile-time dependency injection framework that combines the best of [Dagger](https://github.com/google/dagger), [Anvil](https://github.com/square/anvil), and [kotlin-inject](https://github.com/evant/kotlin-inject) into one cohesive solution.
**Key Features:**
- ✅ **Compile-time validation** – Catch dependency graph errors during compilation, not at runtime
- 🧩 **FIR/IR code generation** – No KAPT or KSP required, just a Kotlin compiler plugin
- 🎯 **Kotlin-first API** – Inspired by kotlin-inject with top-level function injection and optional dependencies
- 🗡️ **Dagger-esque runtime** – Lean generated code with familiar patterns
- ⚒️ **Anvil-style aggregation** – `@ContributesTo`, `@ContributesBinding`, and more
- 🌐 **Multiplatform** – Supports JVM, JS, WASM, and Native targets
- 💡 **Helpful diagnostics** – Detailed error messages with actionable suggestions
- 🔗 **Advanced interop** – Migrate incrementally from Dagger, kotlin-inject, or Guice
- ⚡️ **Fast** - At build time, at runtime
---
## Quick Start
**1. Apply the Gradle plugin:**
```kotlin
plugins {
id("dev.zacsweers.metro") version ""
}
```
**2. Define a dependency graph:**
```kotlin
@DependencyGraph
interface AppGraph {
val repository: UserRepository
@Provides
fun provideApi(): Api = ApiImpl()
}
@Inject
class UserRepository(private val api: Api)
```
**3. Create and use the graph:**
```kotlin
val graph = createGraph()
val repository = graph.repository
```
---
## Documentation
📚 **[zacsweers.github.io/metro](https://zacsweers.github.io/metro/latest/)**
| Topic | |
|----------------------------------------------------------------------------------|------------------------------------------------|
| [Installation](https://zacsweers.github.io/metro/latest/installation/) | Setup and configuration |
| [Dependency Graphs](https://zacsweers.github.io/metro/latest/dependency-graphs/) | Define and create graphs |
| [Provides](https://zacsweers.github.io/metro/latest/provides/) | Provider functions and properties |
| [Injection Types](https://zacsweers.github.io/metro/latest/injection-types/) | Constructor, assisted, and member injection |
| [Scopes](https://zacsweers.github.io/metro/latest/scopes/) | Scoping and lifecycle management |
| [Aggregation](https://zacsweers.github.io/metro/latest/aggregation/) | Anvil-style contributions across modules |
| [Interop](https://zacsweers.github.io/metro/latest/interop/) | Dagger, kotlin-inject, and Guice compatibility |
| [Performance](https://zacsweers.github.io/metro/latest/performance/) | Build and runtime performance |
| [Compatibility](https://zacsweers.github.io/metro/latest/compatibility/) | Supported Kotlin versions |
| [FAQ](https://zacsweers.github.io/metro/latest/faq/) | Frequently asked questions |
| [API Docs](https://zacsweers.github.io/metro/latest/api/) | Generated KDocs |
---
## Supported Platforms
Metro supports JVM, Android, JS, WASM, and Native targets. The compiler plugin works with all Kotlin Multiplatform project types.
See the [multiplatform docs](https://zacsweers.github.io/metro/latest/multiplatform/) for full details.
---
License
-------
Copyright (C) 2025 Zac Sweers
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.