Testlum DEMO APP

Testlum Image Status

| Image | Linux amd64 | Linux arm64 | Windows amd64 | Branch | Last Updated | Mobile Tests | |---|---|---|---|---|---|---| | latest | ❌ | ❌ | ✅ | main | 2026/03/25 | ➖ | | 1.0.2 | ✅ | ✅ | ✅ | main | 2026/03/25 | ➖ |

A comprehensive end-to-end testing application that serves as both a test target and a validation suite for the Testlum testing framework.

🎬 How to Run Regression Tests with Testlum

Learn how to execute existing regression tests using the Testlum framework and the demo repository.

⚠️ To see the browser during web test execution, make sure headless mode is disabled.

By default, tests may run in headless mode (without opening a browser window).
If you want to observe the UI and test flow visually, update your configuration to turn off headless mode before running the tests here and visit http://localhost:7900 by providing secret as a password

Overview

The project consists of three main components:

TEST-API — Spring Boot backend exposing REST, GraphQL, and WebSocket endpoints across multiple integrations
TEST-UI — Vue 3 frontend dashboard used as a target for UI automation tests
REGRESSION — Testlum-based test suite covering all supported integration types

Tech Stack

| Layer | Technologies | |---|---| | Frontend | Vue 3, Vite, TypeScript, Tailwind CSS, CoreUI | | Backend | Spring Boot 2.5.4, Spring Security, Spring Data | | Databases | PostgreSQL, MySQL, Oracle, ClickHouse, MongoDB, DynamoDB | | Caching | Redis | | Message Queues | Kafka, RabbitMQ, AWS SQS | | Cloud | AWS (Lambda, S3, DynamoDB, SQS, SES) via LocalStack | | APIs | REST, GraphQL, WebSocket | | Testing | Testlum Framework, Selenium Grid | | Infrastructure | Docker, Docker Compose, HashiCorp Vault | | Authentication | JWT, Basic Auth |

Prerequisites

Docker and Docker Compose
(Optional) Android emulator for mobile testing

Running the Application

A single script orchestrates the full stack:

./run-app

This will:

Validate Docker is installed and running
Create the e2e_network Docker network
Start all integration services (databases, queues, cloud emulators)
Initialize HashiCorp Vault
Start Selenium Grid
Build and start TEST-API and TEST-UI

To also launch the Android emulator for mobile testing:

./run-app --mobile
# or
./run-app -m

Project Structure

mega-test-app/
├── TEST-API/          # Spring Boot backend
├── TEST-UI/           # Vue 3 frontend
├── REGRESSION/        # Testlum test suite
│   └── resources/
│       ├── scenarios/ # Test scenario definitions (XML)
│       ├── locators/  # UI element locators
│       ├── data/      # Test data (JSON)
│       └── config/    # Execution configurations
├── docker/            # Docker Compose files and init scripts
├── run-app            # Main orchestration script
└── run-android-device # Android emulator setup

Test Coverage

The REGRESSION suite covers:

HTTP — REST APIs, Basic Auth, JWT, GraphQL, WebSocket, multipart uploads
Databases — MySQL, PostgreSQL, Oracle, ClickHouse, MongoDB, DynamoDB
Message Queues — Kafka, RabbitMQ, SQS
Storage — Redis, S3
UI — Web browser, mobile browser, native Android
Mail — SendGrid, SES, SMTP, Twilio
Shell — Shell command execution
Core — Conditions, assertions, variables, data variations

Integration Services

The following services are started via Docker Compose:

| Service | Purpose | |---|---| | PostgreSQL (×2) | Relational DB and auth DB | | MySQL | Relational DB | | Oracle XE 18.4 | Relational DB | | MongoDB 4.2 | Document store | | Elasticsearch 7.12 | Search engine | | ClickHouse | Analytics DB | | Redis 7 | Cache / key-value store | | DynamoDB Local | AWS DynamoDB emulator | | Kafka | Message streaming | | RabbitMQ 3.6 | Message broker | | LocalStack | AWS services (Lambda, S3, SQS, SES) | | HashiCorp Vault | Secrets management | | Selenium Grid | Distributed browser automation |

Running Tests

Test execution is configured via XML files in REGRESSION/resources/config/:

config-local.xml — Local development execution
config-ci-regression.xml — CI pipeline execution
config-ci-regression-mobile.xml — Mobile CI execution

run-regression script

The run-regression script runs the Testlum Docker container against the local test resources.

Usage:

./run-regression

By default it uses the pre-defined values:

Image: ghcr.io/testlumframework/testlum
Config: -c=config-local.xml
Path: -p=<project-root>/REGRESSION/resources

To use dynamic arguments, edit the script and switch to the commented-out dynamic params section, then call:

./run-regression <image-name> -c=<config>.xml -p=<path-to-resources>

Arguments:

| # | Argument | Format | Description | |---|---|---|---| | 1 | Docker image name | <image>:<tag> | Testlum Docker image to run | | 2 | Config file | -c=<file>.xml or --config=<file>.xml | Test configuration file | | 3 | Path to resources | -p=<path> or --path=<path> | Path to the REGRESSION/resources directory |

Example:

./run-regression testlum:1.0.2 -c=config-local.xml -p=/home/user/mega-test-app/REGRESSION/resources

The script validates that Docker is running, all arguments are in the correct format, and the specified resources path exists before launching the container.

Building Individually

Backend (TEST-API):

cd TEST-API
mvn clean package

Frontend (TEST-UI):

cd TEST-UI
pnpm install
pnpm dev      # development server
pnpm build    # production build

Demo

Install / Use

README