Compile-time dependency injection for Kotlin Multiplatform (KMP) with first-class Compose Multiplatform support. Hilt/Dagger-like developer experience — if it compiles, it works.
Anchor DI is a compile-time DI framework for KMP. It uses KSP (Kotlin Symbol Processing) to analyze your annotated code and generate a static dependency graph at build time. No runtime reflection, no service locator — just generated Kotlin code that wires your dependencies.
Built for: Android, iOS, Desktop (JVM), and Web (Wasm). Same API across all platforms.
| Solution | Limitation |
|---|---|
| Koin | Runtime DI; ~5x slower startup; can fail at runtime ("No definition found") |
| Hilt / Dagger | Android-only |
| Manual DI | Boilerplate-heavy; error-prone |
| Reflection-based | Not multiplatform-safe (limited on Native, Wasm) |
Anchor DI validates your dependency graph at compile time — missing bindings, cycles, and scope violations fail the build, not your app.
// build.gradle.kts (shared module)
plugins {
id("anchor-di-convention")
}
anchorDi {
compose = true
}// build.gradle.kts (shared module)
plugins {
id("com.google.devtools.ksp") version "2.3.5"
}
repositories { mavenCentral() }
kotlin {
sourceSets {
commonMain.dependencies {
implementation(platform("io.github.12345debdut:anchor-di-bom:1.0.0"))
implementation("io.github.12345debdut:anchor-di-api")
implementation("io.github.12345debdut:anchor-di-core")
implementation("io.github.12345debdut:anchor-di-compose") // For Compose UI
}
}
}
dependencies {
add("kspCommonMainMetadata", "io.github.12345debdut:anchor-di-ksp:1.0.0")
add("kspAndroid", "io.github.12345debdut:anchor-di-ksp:1.0.0")
add("kspIosArm64", "io.github.12345debdut:anchor-di-ksp:1.0.0")
add("kspIosSimulatorArm64", "io.github.12345debdut:anchor-di-ksp:1.0.0")
}@Singleton
class UserRepository @Inject constructor(
private val api: UserApi
)
@AnchorViewModel
class UserViewModel @Inject constructor(
private val repository: UserRepository
) : ViewModel()
@Composable
fun UserScreen(
viewModel: UserViewModel = viewModelAnchor()
) {
// ViewModel and dependencies are injected automatically
}Anchor.init(*getAnchorContributors())Call once in Application.onCreate() (Android), your app entry (iOS), or before the first Composable.
| Setup | Dependencies |
|---|---|
| KMP + Compose | anchor-di-bom, anchor-di-api, anchor-di-core, anchor-di-compose, anchor-di-ksp |
| KMP without Compose | anchor-di-bom, anchor-di-api, anchor-di-core, optionally anchor-di-presentation, anchor-di-android |
| Multi-module | Add anchorDiModuleId per module; aggregate contributors in your app |
| Convention plugin | Apply anchor-di-convention — handles KSP + deps automatically |
Prerequisites: Kotlin 1.9+, KSP 2.3+, Gradle 8+
| Feature | Description |
|---|---|
| Constructor injection | @Inject on constructors; dependencies resolved automatically |
| Modules | @Module, @Provides, @Binds, @InstallIn |
| Scopes | Singleton, ViewModel, Navigation, custom (@Scoped, Anchor.withScope) |
| Compose | anchorInject(), viewModelAnchor(), navigationScopedInject() |
| Qualifiers | @Named, custom @Qualifier (including parameterized) |
| Multibinding | @IntoSet, @IntoMap, Anchor.injectSet(), Anchor.injectMap() |
| Lazy / Provider | Lazy<T>, AnchorProvider<T> |
| Compile-time validation | Missing bindings, cycles, scope violations fail the build |
| ~5x faster init vs Koin | Benchmarks — compile-time codegen means near-zero startup cost |
| Platform | Status |
|---|---|
| Android | Supported |
| iOS (arm64, simulator) | Supported |
| Desktop (JVM) | Supported |
| Web (Wasm) | Supported |
Full documentation — installation, core concepts, scopes, Compose integration, KMP setup, guides, and troubleshooting.
- Koin Migration Guide — side-by-side comparison for teams moving from Koin
- Benchmarks — performance data: Anchor DI vs Koin
- Changelog — release history
Contributions welcome. See CONTRIBUTING.md for how to build, run tests, and contribute.