![logo](./docs/img/koin_main_logo.png)

[![Kotlin](https://img.shields.io/badge/Kotlin-2.3.20-blue.svg?style=flat&logo=kotlin)](https://kotlinlang.org)
![Github Actions](https://github.com/InsertKoinIO/koin/actions/workflows/build.yml/badge.svg)
[![Apache 2 License](https://img.shields.io/github/license/InsertKoinIO/koin)](https://github.com/InsertKoinIO/koin/blob/main/LICENSE.txt)
[![Slack channel](https://img.shields.io/badge/Chat-Slack-orange.svg?style=flat&logo=slack)](https://kotlinlang.slack.com/messages/koin/)


# What is KOIN? ✨
 
Koin is a pragmatic, lightweight dependency injection framework for Kotlin developers, developed by [Kotzilla](https://kotzilla.io) and open-source [contributors](https://github.com/InsertKoinIO/koin/graphs/contributors).

```
The pragmatic Kotlin & Kotlin Multiplatform Dependency Injection framework
- Simple, Powerful and now Compile-Safe -
```

## Compile-Safe Dependency Injection 🛡️

Koin is now **compile-safe** thanks to the [Koin Compiler Plugin](https://github.com/InsertKoinIO/koin-compiler-plugin). Your dependency graph is verified at compile time — missing bindings, broken definitions, and misconfigured modules are caught by the compiler instead of crashing at runtime.

- Catch missing or invalid dependencies before you run your app
- Keep Koin's concise, idiomatic DSL — no extra boilerplate
- Works across Kotlin & Kotlin Multiplatform targets

Get started with the [Koin Compiler Plugin](https://github.com/InsertKoinIO/koin-compiler-plugin).


## Setup & Current Version 📦

Follow the dedicated [setup page](https://insert-koin.io/docs/setup/koin) to setup Koin for your project.
Here are the currently available Koin versions:

- **Latest** Version : [![Maven Central](https://img.shields.io/maven-central/v/io.insert-koin/koin-core)](https://mvnrepository.com/artifact/io.insert-koin/koin-core)


## Developer Tools & Observability 🛠️

### Kotzilla Platform — KMP Crash Reporting & Observability

Free signup on [Kotzilla](https://kotzilla.io)

> The full observability platform for Kotlin Multiplatform apps:
> - **Full KMP Crash Reporting** — complete crash reports across Android, iOS and all KMP targets
> - **Screen Rendering Impact** — understand how each screen affects rendering and user experience
> - **Performance Monitoring** — track runtime performance, memory metrics, and Koin module behavior
>
> A console-based suite with connected cloud services that visualizes your Koin module structure, provides advanced debugging and tracing, and seamlessly integrates with Kotlin Multiplatform projects.

### Koin IDE Plugin — Your Koin Developer Assistant

Freely available on the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/26131-koin-dependency-injection-official-/versions/stable)

> The perfect Koin developer assistant: native support for IntelliJ IDEA and Android Studio, with navigation, inspections, and productivity features dedicated to Koin across Kotlin and Kotlin Multiplatform projects.


## Community & Enterprise Support 💬

Koin is backed by an active open-source community and by Kotzilla for teams that need guaranteed, enterprise-grade support.

### Community Support 🌱

Free, open-source support from the Koin community:

- Chat with us on the Kotlin Slack [#koin](https://kotlinlang.slack.com/?redir=%2Fmessages%2Fkoin) channel
- Ask questions on [Stack Overflow](https://stackoverflow.com/questions/tagged/koin) with the `koin` tag
- Found a bug or have a feature request? Open an issue on [GitHub](https://github.com/InsertKoinIO/koin/issues)
- Follow releases and announcements on the [Koin blog](https://blog.insert-koin.io) and [@insertkoin_io](https://twitter.com/insertkoin_io)

### Enterprise-Grade Support with Koin LTS 🏢

For teams with production and compliance requirements, [**Koin LTS**](https://kotzilla.io/koin-lts) delivers enterprise-grade support backed by Kotzilla:

- **SLA-backed updates** and guaranteed response times
- **Long-term maintenance** on stabilized Koin versions (e.g. Koin 3.5 LTS)
- **Security & compliance patches** aligned with enterprise requirements
- **Direct access to Kotzilla experts** — the team behind Koin
- **Priority bug fixes** and advisory support for architecture and migration

👉 Learn more and opt in at [kotzilla.io/koin-lts](https://kotzilla.io/koin-lts).

## Latest News & Resources 🌐
- Official Website: [insert-koin.io](https://insert-koin.io)
- Twitter: [@insertkoin_io](https://twitter.com/insertkoin_io)
- Blog: [Koin Developers](https://blog.insert-koin.io)

## Contributing 🛠

Want to help or share a proposal about Koin? Problem with a specific feature? 

- Open an issue to explain the issue you want to solve [Open an issue](https://github.com/InsertKoinIO/koin/issues)
- Come talk on slack [#koin-dev](https://kotlinlang.slack.com/?redir=%2Fmessages%2Fkoin-dev) channel
- After discussion to validate your ideas, you can open a PR or even a draft PR if the contribution is a big one [Current PRs](https://github.com/InsertKoinIO/koin/pulls)

Additional readings about basic setup: https://github.com/InsertKoinIO/koin/blob/master/CONTRIBUTING.adoc

### Contributors

Thank you all for your work! ❤️

<a href="https://github.com/InsertKoinIO/koin/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=InsertKoinIO/koin" />
</a>

## OpenCollective - Sponsorship ❤️

Support this project by becoming a sponsor and be displayed on the offcial website. [[Help us and Become a sponsor!](https://opencollective.com/koin#sponsor)]
