QAick Runner

Standalone execution application for QAick artifacts.

Runner is developed independently from QAick Studio. Studio produces durable QAick execution packages; Runner loads, configures, executes and reports their execution evidence.

Alpha 1

The first slice establishes Runner's own application shell and execution UI. The engine and package protocol will be added behind this UI boundary.

Design references

• Runner Alpha 1 plan
• Runner Alpha 2 plan
• Runner package contract
• Runner Alpha 1 acceptance record
• Runner UI draft prototype
• Runner UI draft image
• Deployment guide

Run locally

Install dependencies, then start the Vite development server:

npm install
npm run dev

Open the local URL printed by Vite, usually http://localhost:5173.

To create and preview a production build:

npm run build
npm run preview

To verify from a clean dependency installation, run npm run verify:clean.

To open the Studio-style Runner feature demo, click View demo in the Runner shell or open http://localhost:5173/?demo. The walkthrough uses selectable steps, a simulated Runner screen, callouts, and Next/Back navigation without changing the loaded package.

The visible loop hierarchy demo is stored at fixtures/checkout-nested.qaick.json. It is also preloaded in the app as Customer Checkout · Loop Demo.

Runner also accepts Studio schema 7 Flow artifact envelopes (artifactKind: "flow"). A representative fixture is fixtures/studio-flow-v7.qaick.json. Operation catalog resolution and a canonical artifact exported directly from Studio remain conformance work.

HTTP Actions with http.* identifiers are executed in the browser through fetch. The target API must allow browser CORS requests; successful responses are captured as status, body, and headers outputs.

If Runner reports that a Studio project uses an outdated schema, open that project in QAick Studio, save it, and load the newly saved file in Runner.

QAick Runner

QAick Runner is a reusable execution and evidence UI for QAick packages. The published package exposes the Runner module for host applications and keeps the standalone Vite application in this repository.

Package usage

Install the published package and its peer dependencies, then import the module, host adapter, and stylesheet through the stable exports:

import { RunnerModule } from 'qaick-runner-fe/runner-module';
import { createRunnerRuntimeClient } from 'qaick-runner-fe/runtime-client-adapter';
import 'qaick-runner-fe/styles.css';

RunnerModule receives a host-provided RunnerRuntimeClient. The package does not create an Electron host or choose a transport for the consuming application.