Browser UI

A full-featured, zero-build Single Page Application for interactive load testing.

Overview

Overload comes with a beautiful vanilla JS web interface built on top of a FastAPI backend. It allows you to configure, execute, and monitor load tests visually.

To start the UI, simply run:

overload ui

This will start the local server and automatically open http://localhost:3000 in your browser.

Key Features

• Auto-discovery: Automatically detects .json Postman collections and environments in your current working directory.
• Live Dashboard: Real-time Chart.js visualisations for RPS, error rates, and latency distribution using WebSockets.
• Visual Configuration: Intuitive sliders and inputs for configuring all 10 load testing patterns.
• Assertions Editor: Add and remove pass/fail conditions interactively.
• Save/Load Config: Easily save your configured test settings to an overload.config.yaml file for CLI/CI reuse.

1. Collection View

The first screen you see is the Collection View. Here you can:

• Select or upload your Postman Collection and Environment files.
• Browse the structure of your API requests.
• View specific request details (headers, URL, body).
• Override variables interactively.

2. Test Runner View

The Runner View is the command center for your load test. You can choose from 10 different load profiles (e.g., Load, Spike, Soak) and adjust their specific parameters like Target RPS, Duration, or Concurrency.

As you change parameters, a small mini-chart updates to preview the expected traffic shape of your test.

While the test is running, this page transforms into a live dashboard showing real-time metrics and a scrolling log of recent HTTP requests.

3. Results View

The Results View keeps a history of all runs executed during the current session. For each run, you can:

• See the Pass/Fail verdict.
• View the final metric summary.
• Download the standalone HTML report.
• Export the raw data as JSON.