QualityMax Test Runner

Run QualityMax tests in your CI/CD pipeline. AI-powered test automation with quality gates.

Quick Start

name: Tests
on: [pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: Quality-Max/qmax-action@v1
        with:
          api-token: ${{ secrets.QMAX_TOKEN }}
          project-id: '42'

Inputs

Input	Required	Default	Description
api-token	Yes	—	QualityMax API token
project-id	Yes	—	Project ID
script-ids	No	all	Comma-separated script IDs
base-url	No	—	Base URL override (e.g. preview deploy URL)
browser	No	chromium	Browser: chromium, firefox, webkit
comment	No	true	Post results as PR comment
fail-on-test-failure	No	true	Fail action on test failures
qmax-version	No	latest	qmax CLI version

Outputs

Output	Description
status	passed or failed
total	Total test count
passed	Passed count
failed	Failed count
duration	Duration in seconds
summary	Markdown summary

Examples

Run specific tests

- uses: Quality-Max/qmax-action@v1
  with:
    api-token: ${{ secrets.QMAX_TOKEN }}
    project-id: '42'
    script-ids: '101,102,103'

Test preview deploys (Vercel/Netlify)

- uses: Quality-Max/qmax-action@v1
  with:
    api-token: ${{ secrets.QMAX_TOKEN }}
    project-id: '42'
    base-url: ${{ steps.deploy.outputs.url }}

Non-blocking (don't fail on test failures)

- uses: Quality-Max/qmax-action@v1
  with:
    api-token: ${{ secrets.QMAX_TOKEN }}
    project-id: '42'
    fail-on-test-failure: 'false'

Setup

1. Get your API token from QualityMax Settings
2. Add it as a repository secret: QMAX_TOKEN
3. Add the action to your workflow

How it works

1. Installs the qmax CLI
2. Authenticates with your API token (headless, no browser needed)
3. Runs your test suite on QualityMax infrastructure
4. Posts results as a PR comment
5. Fails the workflow if tests fail (quality gate)

---

Built by QualityMax — AI-powered test automation