Valtimo is the low-code platform for Business Process Automation. Our goal is to make implementing business process automation and case management easy.

• Valtimo consists of two services:
  • A Spring Boot Java/Kotlin backend
  • An Angular frontend
• Valtimo depends on two services:
  • Keycloak as an identity and access provider
  • A database (default is PostgreSQL)

This repository contains:

• A collection of Java/Kotlin libraries that together form the Valtimo backend.
• The app:gzac module, containing a Spring Boot application, used for library development.

Starting up the Valtimo platform requires two steps:

1. Starting the Valtimo backend. Instructions can be found here.
2. Starting the Valtimo frontend. Instructions can be found here

• Java 17
• Docker (Desktop)
• (Optional) An IDE like IntelliJ or Eclipse

Run the following command to start the Spring Boot application: ./gradlew :app:gzac:bootRunWithDocker.

Keycloak management can be accessed on http://localhost:8081 with the default credentials of username admin and password admin.

Keycloak comes preconfigured with the following users.

• Run the following command to run the unit tests: ./gradlew test.
• Run the following command to run the integration tests using a PostgreSQL database: ./gradlew integrationTestingPostgresql.
• Run the following command to run the integration tests using a MySQL database: ./gradlew integrationTestingMysql.
• Run the following command to run the security tests: ./gradlew securityTesting.

Contributions are welcome! To get you in the right direction, please consult the Valtimo documentation for guidelines on how to contribute.

For contributing code, please refer to the coding guidelines.

For more information on what branches to create while working in this project, please refer to this page.

The source files in this repo are licensed under the EUPL 1.2. If you have any questions about the use of this codebase in a larger work: please reach out through the Valtimo website.

• Website: https://www.valtimo.nl
• Documentation: https://docs.valtimo.nl