woq-blended / blended

An OSGI container framework in Scala with focus on testing and integration testing.

Website GitHub

Blended - a Scala based Integration framework

Project Mission

Blended provides a Scala based integration framework to easily develop component based applications on top of Akka, AkkaHttp, JMS and other communication libraries.

The Blended runtime components provide a well defined environment for the user defined components and provides common services for component configuration, security services standard integrations to an enterprise level infrastructure, such as messaging services or authentication and authorization servers.

The Blended management framework allows to monitor and manage a large number of distributed framework containers without sacrificing the stability of the environment when the management infrastructure is unavailable.

The Blended test framework allows to execute functional cross-component tests mimicking the final container environment with minimal effort.

The Blended integration test framework uses docker to create and deploy docker images from within the build process and supports the developer in creating integration tests for the final container.

Blended is the backend for a distributed retail communication software. All components and services not directly related to the actual business components are licensed under the Apache 2.0 license.

Currently blended is in it’s 3rd generation and in production since ~2014.

The next upcoming release will complete the migration to Scala 2.12 and finalize the migration from maven to sbt.

Blended Integration Test Framework

The Blended Integration Test Framework to create docker based integration tests.

Blended Management UI

A web front end the Blended Management Framework built with Scala.Js.

Blended example container and integration tests

Some packaging examples and simple integration flows complete with packaging and integration tests.

Build from source

We use sbt 1.2.8 to build blended.

The build files are not compatible with sbt versions 0.13.x as they intensively use the new unified syntax to reference properties.

As we have some shared modules between Scala and Scala.Js, node and yarn is also required on the developer machine.

After cloning the repository, simply navigate to the checkout directory and start sbt with a bit more memory (2GB or more):

sbt -mem 2048

The first start might take a moment as sbt needs to download the required dependencies.

For convenience we have defined some command aliases for sbt:


; clean ; coverageOff ; publishM2


; clean ; coverage ; test ; coverageReport ; coverageAggregate ; coverageOff

IDE support

We use IntelliJ in our project and the project opens well enough in IntelliJ, though the import of the sbt file can take a moment.

There is an experimental support for the Scala Compile Server, bloop. Currently we cannot use it as there seems to be an issue with loading mixed JVM / JS projects. Once that is solved, the bloop support should give a very good performance loading / refreshing and compiling the project.

Download artifacts from Maven Central

You can download released artifacts including binary and source JARs from Maven Central.


Blended ist published under the Apache License, Version 2.0


Why not just clone our repo, dig around and send us some pull requests …​.


JetBrains is kindly supporting our project with full developer licenses of their product stack.


We are keen to know what you think about Blended. What are your use cases, your wishes?

If you spot something that makes you want to pull your hair, let us know ;)