Micronaut Multi-project module build tutorial

[krickert]

https://krickert.github.io/micronaut-multiproject-example/

This page is a tutorial I wrote. It's a tutorial on how to create a multi-project file using micronaut on JDK21 using gradle kts building.

If anyone wants to give this a whirl, or add more relevant builds to it (maven, groovy, kotlin?) - feel free. I'll put more details and document the "tutorial" part of this.

This is going to eventually become a book - the goal being a single project that demonstrates a fairly complex application but would be simple to understand.

Here's the code for it:
https://github.com/krickert/micronaut-multiproject-example

This setup is going to be my template to bring all my side projects into a single umbrella. I found myself spending too much time dealing with managing dependencies between multiple projects and noticed a lot of challenges for keeping up with the latest libraries.

The tutorial is a hands-on linux/osx one. When the code is done, this will be a tutorial on how to create a pipeline multi-project container with micronaut using gRPC and kafka as backbone service communication.

[TatyOko28]

Goal

The goal is a single project that demonstrates a fairly complex application while remaining simple to understand. This will eventually become a book.

The tutorial is hands‑on (Linux / macOS). When complete, it will show how to build a pipeline multi‑project container with Micronaut using gRPC and Kafka as the backbone service communication.

This setup will serve as a template to bring all side projects under a single umbrella, reducing time spent managing dependencies and keeping up with library updates.

Current Status

• Multi‑project structure with Gradle Kotlin DSL
• JDK21 compatibility
• Basic Micronaut integration
• More to come (gRPC, Kafka, pipeline, containerization)

How You Can Contribute

Contributions are very welcome! Whether you want to add examples, improve the tutorial text, or add alternative build setups, please feel free.

Areas where help is especially appreciated

Area	Description
Maven build	Add a Maven version of the multi‑project setup
Groovy DSL	Convert or supplement the Gradle build with Groovy DSL
Kotlin (language)	Add Kotlin language examples alongside Java
gRPC integration	Help implement gRPC service definitions and clients
Kafka integration	Add event‑driven communication examples
Containerization	Docker / Podman / Kubernetes setup
Pipeline examples	CI/CD (GitHub Actions, GitLab CI, Jenkins)
Testing	Add integration tests, testcontainers, etc.
Documentation	Expand the tutorial text, add diagrams, fix typos

Contribution workflow

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a Pull Request

Repository: https://github.com/krickert/micronaut-multiproject-example

Quick Start (for contributors)

# Clone the repository
git clone https://github.com/krickert/micronaut-multiproject-example.git
cd micronaut-multiproject-example

# Build the project
./gradlew build

# Run tests
./gradlew test

# Run a specific module
./gradlew :module-name:run