• Ensure docker desktop is installed and running.

##Configure steps to take after templating

Adjust Gradle properties file

Adjust the projectName to a global name for the project.
Don’t focus on the first bpmn process name for example but rather take yor time and find an overarching name.
Here you can also control the main libraries for Spring/Kotlin/Valtimo.


Choose DB provider in

In the docker-compose.yml there are 2 main dbs to choose from Mysql or Postgres.

Keycloak defaults

Keycloak also is part of the default setup but can be left as is.
Note that 3 users are default added to a valtimo realm.
admin:admin, user:user and developer:developer.


This file contains the test db which is used when running integrationTest task in gradle.

Auto-configuration (no annotations approach)

Ritense recommends to use autoconfigures over annotation based classes (Service/RestController etc.).
This allows spring to be snappier when starting up because scanning the whole project is slower.
Also creating a overview of what your project needs is better approach when testing the implementation for instance.
Create autoconfigures for your implementation in com.ritense.valtimo.autoconfigure,
once created add them to the meta-inf/spring.factories to be picked up

Setup integration testing

Open BaseIntegrationTest and add the autoconfigures from previous step.
If you want to control Valtimo startup flow comment/uncomment/add autoconfigure in TestConfiguration


View Github