Skip to main content

What is Kolibrium?

Kolibrium is a comprehensive, type-safe testing toolkit for Kotlin that unifies API testing and browser automation. Write maintainable tests with minimal boilerplate using modern Kotlin features and declarative APIs.

Kolibrium is divided into two main areas, each with modular components that can be used independently or together:

API Testing​

  • api-core: Core functionality for API testing including HTTP client utilities and response handling
  • api-ksp-annotations: Annotations for defining API specifications, requests, and responses
  • api-ksp-processors: Kotlin Symbol Processing (KSP) that automatically generates type-safe HTTP clients and test harness functions from annotated request models

Browser Automation​

  • selenium: Core WebDriver functionality including Page Object base classes, the webTest harness, element locator delegates, and an extensible decorator framework

Usage Patterns​

You can use Kolibrium modules independently based on your needs:

  • API testing only: Use api-core + api-ksp-annotations + api-ksp-processors for auto-generated, type-safe API clients
  • Browser testing only: Use selenium for declarative Selenium-based UI tests
  • Full-stack testing: Combine both for end-to-end test automation covering APIs and user interfaces

All modules emphasize type-safety, minimal boilerplate, and idiomatic Kotlin code.