@ychebotaev/aurora-playwright-reporter

Self-contained HTML reporter for Playwright visual parity between two application versions (original vs new), not classic baseline-vs-current goldens.

The report is a single offline HTML file: styles, Alpine.js, and screenshots are inlined as data URLs.

Install

npm install -D @ychebotaev/aurora-playwright-reporter

Configure

// playwright.config.ts
import { defineConfig } from '@playwright/test'

export default defineConfig({
  reporter: [
    ['list'],
    [
      '@ychebotaev/aurora-playwright-reporter',
      {
        name: 'Visual parity report',
        outputFile: './aurora-report/index.html',
      },
    ],
  ],
})

Attachment naming

Attach screenshots with monocart-compatible names so the reporter can group them:

• <name>-expected — original / legacy
• <name>-actual — new
• <name>-diff — pixel diff

Options

| Option | Default | Description | | --- | --- | --- | | name | Test Report | Title suffix (YYYY-MM-DD — name) | | outputFile | ./aurora-report/index.html | HTML output path | | merge | true | Merge incremental runs via report-state.json |

Development

npm install
npm run build
npm test
npm run test:e2e

Tooling:

• TypeScript + tsup
• Oxlint
• Vitest (unit)
• Playwright (classic visual baselines for report chrome)
• Husky: commitlint (conventional commits), lint-staged, unit tests

Publish

CI builds and verifies on every push/PR. Pushing a v* tag publishes to npm via GitHub Actions (NPM_TOKEN secret required).