Allure 3 integration for Katalon Studio listing as offcial integration tool ?

[montbaga]

I built a zero-touch Allure 3 integration for Katalon Studio (https://github.com/montbaga/allure3-katalon-bridge,
also on npm: https://www.npmjs.com/package/allure3-katalon-bridge) and wanted to check whether there's a
process to get it listed among the framework integrations on the docs site.

Katalon has no first-party Allure adapter, so I maintain two open source bridges that add one. The Allure 3 version is out now and I wanted to share it here, along with one gotcha that will bite anyone moving from Allure 2.

Install
Needs Node.js 18 or newer.

npx allure3-katalon-bridge install "/path/to/your/katalon/project"

There are also double-click installers under Windows/, macOS/ and Linux/ if you would rather not use a terminal.

It copies a Test Listener, some Keywords, config and two jars into the project. Katalon auto-discovers the listener, so nothing else is wired up. No plugin, no OSGi packaging, and no changes to your existing Test Cases or Test Suites. Re-running it upgrades in place, and uninstall removes exactly what it installed.

What you get
Run any Test Suite or Test Suite Collection as normal. Afterwards you get one self-contained .html in allure-report/ that you open by double clicking. No server, no separate allure generate step.

A Test Suite Collection produces one combined report named after the collection, not one report per member suite.

You also get failure screenshots for WebUI tests, Katalon log lines as nested Allure steps, browsers as first-class Allure environments, and trend and retry history that carries forward between runs.

There is no global Allure install. The Allure 3 CLI is a Node program, so it ships pinned inside the package and its exact path is recorded at install time. If you ever fought with Katalon Studio not finding allure on PATH when launched from the Start Menu or Dock, that class of problem is gone.

The gotcha if you are coming from Allure 2
Allure 3 reads Allure 2 results natively, so it is tempting to point allure 3.x at an existing Allure 2 bridge’s output. Do not. You get a report that looks fine and is not.

Allure 3 ignores the historyId a result declares and recomputes its own, then groups retries and shows only the newest attempt in each group. Katalon reuses one test case across many suites under a single testCaseId. Put those together and separate runs of the same test case look like retries of each other.

On a real six result run with one genuine failure, that showed two tests and reported the build as passed. The failing run was hidden behind a later passing one.

This bridge writes a Suite parameter, a browser label and a Browser parameter so each execution keeps its own identity, in the report body and in history. Same run, same results: six tests, reported failed.

CI
Verified on Azure Pipelines hosted agents for Windows, macOS and Ubuntu. Ready-to-copy configs are in the repo for Azure Pipelines, GitHub Actions and GitLab CI.

Two things Linux needs that the other two do not, both included in the example config: Xvfb, because Katalon Studio is an Eclipse application and wants a display even when the browser runs headless, and JDK 21, because Katalon 11.x’s OSGi bundles require it and the Ubuntu image does not default to it.

Happy to adjust anything (docs format, structure) if there's interest in listing it. Let me know what the
right next step would be.

[baev]

https://github.com/orgs/allure-framework/discussions/3462

[montbaga]

Hello Dmitry, @baev 3500 is for allure3 while the previous one is for allure2 Regards Monty

…

On Mon, 21 Sept 2026, 17:04 Dmitry Baev, ***@***.***> wrote: Closed #3500 <#3500> as duplicate. — Reply to this email directly, view it on GitHub <#3500?email_source=notifications&email_token=APOZCIXGAJC7N6KNEJETNSD5QEYNDA5CNFSNUABTM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SFOZSW45B2HJHG65DJMZUWGYLUNFXW4LZSHA2TGNBSGOTHEZLBONXW5JTBOV2GQ33SUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/APOZCITKATVTXV5PAG3PATT5QEYNDAVCNFSNUABHKJSXA33TNF2G64TZHM2TSOBTHA3TQOB3IRUXGY3VONZWS33OHMYTAOBVGY3DAONBOYBA> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/APOZCISMURTACISNUVXVW4T5QEYNDA5CNFSNUABTM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SFOZSW45B2HJHG65DJMZUWGYLUNFXW4LZSHA2TGNBSGOTHEZLBONXW5JTBOV2GQ33SUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/APOZCIXKMLVPKHSYLESLRN35QEYNDA5CNFSNUABTM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SFOZSW45B2HJHG65DJMZUWGYLUNFXW4LZSHA2TGNBSGOTHEZLBONXW5JTBOV2GQ33SUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you authored the thread.Message ID: <allure-framework/allure2/repo-discussions/3500/discussion_event/2853423@ github.com>