DEV Community 👩‍💻👨‍💻

Cover image for How to manage dependencies between Gradle modules?
Aldo Wachyudi
Aldo Wachyudi

Posted on • Updated on

How to manage dependencies between Gradle modules?

In a multimodule project, managing dependencies manually can be challenging. For example, if you forget to update a library version after modifying a library version on another module, your project will have a duplicate library.

Starting from Gradle 7.4.1, version catalog is the recommended way of managing dependencies between Gradle projects (also known as a module).

To use the version catalog, simply add libs.versions.toml file inside gradle folder (yourproject/gradle/libs.versions.toml)

├── app
│   ├── build.gradle.kts
│   ├──
│   └── src
├── gradle
│   ├── libs.versions.toml
│   └── wrapper
│      ├── gradle-wrapper.jar
│      └──
├── build.gradle.kts
├── gradlew
├── gradlew.bat
└── settings.gradle.kts
Enter fullscreen mode Exit fullscreen mode

Inside the libs.versions.toml file, you can add the dependencies of your projects.

compose = "1.2.1"

compose-foundation = { module = "", version.ref = "compose" }
compose-material = { module = "androidx.compose.material:material", version.ref = "compose" }
compose-tooling = { module = "androidx.compose.ui:ui-tooling", version.ref = "compose" }
compose-ui = { module = "androidx.compose.ui:ui", version.ref = "compose" }

compose = ["compose-foundation", "compose-material", "compose-tooling", "compose-ui"]
Enter fullscreen mode Exit fullscreen mode

That's it! The dependencies are available across your Gradle projects.

Here is how you use the dependencies in your project's build.gradle.kts.

dependencies {
Enter fullscreen mode Exit fullscreen mode

Note that Gradle converts the dash (-) separator to dot (.). From compose-foundation to

Other benefits of using version catalogs are:

  • Centralized version for some libraries.

By using version.ref, we can assign the same compose version for each library. So, you just need to update a library version in one place.

  • Grouping dependencies.

Oftentimes, we have many dependencies that should be declared together. We can make the dependencies declaration shorter by using bundle, like this.

dependencies {
Enter fullscreen mode Exit fullscreen mode


By using the version catalog, we can manage dependencies easier. This can be useful for a multimodule project, which is common in a mid-sized or large-sized software project.

Heads over to the official Gradle documentation for more detail.


  • Gradle introduces version catalog since version 7.0, but it's still marked as an experimental feature.

  • Photo taken by redcharlie

Top comments (0)

Now it's your turn.

Join DEV and share your story.