pdf-report-forge

PDF reports for Playwright Test. Three templates for developers, QA teams, and stakeholders — CI-ready and fully self-contained.

Drop it into any Playwright project and get a branded PDF on every CI run. No changes to your tests.

Docs · Pricing · Support

Report Gallery

Three templates, one reporter. Every PDF is fully offline — fonts, charts, and screenshots are embedded.

Features

• 3 templates — minimal (developer), detailed (QA team), executive (stakeholders)
• Detailed reports — KPI dashboard, suite breakdown, failure deep-dive with screenshots, CI/CD environment
• Embedded Chart.js — pass-rate doughnut + per-suite bar chart, bundled inline (no CDN)
• Self-contained PDFs — screenshots, fonts, logos all embedded; share or archive with confidence
• Custom branding — logo, primary/accent colours, watermark, PDF password encryption
• Dynamic filenames — {date}, {branch}, {status} tokens in the output path
• CI/CD snippets — GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins, Azure DevOps
• Hybrid licensing — one short key unlocks it; reports keep rendering offline via a cached JWT between refreshes

Quick Start

npm install --save-dev pdf-report-forge puppeteer-core

// playwright.config.ts
import { defineConfig } from '@playwright/test';
import { defineReporterConfig } from 'pdf-report-forge';

export default defineConfig({
  reporter: [
    ['pdf-report-forge', defineReporterConfig({
      template: 'detailed',
      outputFile: 'reports/{date}-{branch}-{status}.pdf',
    })],
  ],
  use: { screenshot: 'only-on-failure' },
});

defineReporterConfig is an optional typed identity helper — it gives you IntelliSense and type-checking on the options object without a separate ReporterOptions import. You can also pass a plain object literal if you prefer.

npx playwright test
# → reports/2026-05-01-main-failed.pdf

License required. Start a 7-day free trial at reportforge.org/pricing — card required, no charge until day 8. Paste the resulting RFSU-… key into RF_LICENSE_KEY. Without a valid license the reporter logs a warning and skips PDF generation; your Playwright tests still run normally.

Installation

Requirements

• Node.js ≥ 18
• @playwright/test ≥ 1.40 (peer dependency)
• puppeteer-core ≥ 21 (peer dependency)
• Chrome or Chromium installed on the machine

Chrome setup

The reporter auto-detects Chrome via PUPPETEER_EXECUTABLE_PATH, then system Chrome, then chrome-finder. Full per-OS instructions: reportforge.org/docs#chrome-setup.

Windows

winget install Google.Chrome
$env:PUPPETEER_EXECUTABLE_PATH = "C:\Program Files\Google\Chrome\Application\chrome.exe"

Linux (Debian / Ubuntu)

wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | \
  sudo gpg --dearmor -o /usr/share/keyrings/google-chrome.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome.gpg] \
  http://dl.google.com/linux/chrome/deb/ stable main" | \
  sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt-get update -qq && sudo apt-get install -y google-chrome-stable
export PUPPETEER_EXECUTABLE_PATH=/usr/bin/google-chrome-stable

Note: Do not use the chromium-browser apt package — it installs as a snap on Ubuntu and Puppeteer cannot drive it.

macOS

brew install --cask google-chrome
export PUPPETEER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

Or set the path in playwright.config.ts:

reporter: [['pdf-report-forge', {
  puppeteerExecutablePath: '/usr/bin/google-chrome-stable',
}]]

Pricing

| Plan | Price | Includes | |---|---|---| | Monthly | ₹999 / month | All three templates · custom branding · PDF encryption · up to 25 active machines · priority email support | | Yearly | ₹8,499 / year | Everything in Monthly · ~31% saving vs monthly |

Configuration

All options are the second element of the reporter tuple.

| Option | Type | Default | Description | |---|---|---|---| | template | 'minimal' \| 'detailed' \| 'executive' or array | 'minimal' | Template(s) to generate. Pass an array to produce one PDF per template — the template name is appended automatically (e.g. report-detailed.pdf). | | outputFile | string | 'playwright-report/{date}-report.pdf' | Output path (supports tokens) | | reportTitle | string | 'Playwright Test Report' | Title in header and cover | | projectName | string | from package.json | Project name shown in report | | logo | string | — | Path to logo image (PNG / JPG / SVG) | | primaryColor | string | '#CC785C' | Brand colour (hex) | | accentColor | string | '#3F7D58' | Accent colour (hex) | | watermark | string | — | Diagonal watermark text (e.g. 'CONFIDENTIAL') | | pdfPassword | string | — | Password-protect the PDF (requires qpdf) | | licenseKey | string | env RF_LICENSE_KEY | Subscription key (format RFSU-…) | | compressionLevel | 'auto' \| 'none' \| 'balanced' \| 'max' | 'auto' | Screenshot JPEG quality + inline failure cap | | maxInlineFailures | number | derived from compressionLevel | Cap on inline failures; overflow spills to {basename}-failures.json | | maxFileSizeMb | number | 8 | Soft cap; reporter re-renders with max compression once if exceeded | | serverUrl | string | 'https://reportforge.org' | Licensing server base URL (override only for self-hosting) | | open | boolean | false | Open PDF after generation (local only) | | puppeteerExecutablePath | string | auto-detect | Path to Chrome / Chromium |

Full reference: reportforge.org/docs#configuration.

Filename tokens

| Token | Replaced with | Example | |---|---|---| | {date} | YYYY-MM-DD (UTC) | 2026-04-21 | | {branch} | Git branch, sanitised | feature-auth | | {status} | Overall verdict | passed / failed / timedout / interrupted |

Templates

minimal — Developer-focused

Clean layout, KPI numbers, hierarchical test table, failure details with stack traces and embedded screenshots. Fast to generate. Good for local development and PR checks.

detailed — QA Team

Everything in minimal, plus Chart.js pass-rate + suite-results charts, a numbered defect log, a requirements traceability matrix derived from @TAG annotations, and the full CI/CD environment table.

executive — Stakeholder presentations

Full-page cover with verdict + KPI strip, followed by a compact dashboard with charts and a failures summary (titles only — no raw stack traces). Best for sprint reports and management dashboards.

Generating multiple templates in one run

Pass an array to template to generate one PDF per template from a single test run. The template name is appended to the output filename automatically:

// playwright.config.ts
reporter: [
  ['pdf-report-forge', {
    template: ['detailed', 'executive'],
    outputFile: 'reports/{date}-report.pdf',
    licenseKey: process.env.RF_LICENSE_KEY,
  }],
]

# → reports/2026-04-28-report-detailed.pdf
# → reports/2026-04-28-report-executive.pdf

One license check, one data-collection pass — faster than multiple reporter instances. Duplicate entries are silently deduplicated.

CI/CD Integration

Full workflows for all four CI providers: reportforge.org/docs#ci-cd.

GitHub Actions

- name: Run Playwright tests
  run: npx playwright test
  env:
    RF_LICENSE_KEY: ${{ secrets.RF_LICENSE_KEY }}
    PUPPETEER_EXECUTABLE_PATH: /usr/bin/google-chrome-stable

- name: Upload PDF report
  if: always()
  uses: actions/upload-artifact@v4
  with:
    name: playwright-pdf-report
    path: reports/*.pdf

GitLab CI

playwright-tests:
  image: mcr.microsoft.com/playwright:v1.49.0-jammy
  script:
    - npm ci && npx playwright test
  artifacts:
    paths: [reports/*.pdf]
    when: always
    expire_in: 30 days

Bitbucket Pipelines

image: mcr.microsoft.com/playwright:v1.49.0-jammy
pipelines:
  default:
    - step:
        name: Playwright Tests + PDF Report
        caches: [node]
        script:
          - npm ci
          - npx playwright test
        artifacts:
          - playwright-report/*.pdf

Set RF_LICENSE_KEY in Repository Settings → Repository variables.

Jenkins

stage('Playwright Tests') {
  withCredentials([string(credentialsId: 'rf-license', variable: 'RF_LICENSE_KEY')]) {
    sh 'npx playwright test'
  }
  archiveArtifacts artifacts: 'reports/*.pdf', allowEmptyArchive: true
}

Azure DevOps

- script: npx playwright test
  env: { RF_LICENSE_KEY: $(RF_LICENSE_KEY) }
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: reports
    artifact: playwright-pdf-report

Licensing

ReportForge ships a hybrid offline-first model:

1. Paste your RFSU-… key into the config once (or set RF_LICENSE_KEY).
2. On first run the reporter activates against the license server, receives a short-lived Ed25519-signed JWT, and caches it at ~/.reportforge/license.json.
3. Every subsequent run is fully offline — the cached JWT is verified locally against a public key bundled into the npm package. No network call.
4. When the cache has less than 24 hours left, the reporter refreshes it in the background.
5. Each subscription allows up to 25 active machines in any rolling 30-day window. Machines that haven't run in 30 days are pruned automatically.

Cancel the subscription and the reporter keeps working until the end of the current billing period, then stops generating PDFs until you restart. A license issue never aborts your test run — the reporter logs a warning and skips PDF generation; your Playwright tests still pass.

export RF_LICENSE_KEY=RFSU-XXXX-XXXX-XXXX-XXXX
npx playwright test

Full lifecycle + offline failure modes: reportforge.org/docs#license.

Requirements Traceability

The detailed template generates a requirements matrix from test tags. Tag tests to link them to requirements:

test('@REQ-101 user can login', async ({ page }) => { /* ... */ });
test.describe('@FEAT-payment', () => { /* ... */ });

The matrix rolls tests up per tag with pass count, fail count, and coverage percentage.

Troubleshooting

Set RF_DEBUG=1 to log the full activation flow and error stack traces:

RF_DEBUG=1 npx playwright test 2>&1 | grep '\[reportforge\]'

Common issues:

• Chrome/Chromium not found → install Google Chrome Stable; don't use the Ubuntu chromium-browser snap.
• Charts blank → ensure npm run bundle-chartjs ran at build; the reporter waits up to 30s for window.__chartsReady.
• pdfPassword ignored → requires qpdf on PATH (apt install qpdf / brew install qpdf / choco install qpdf).
• No PDF generated → verify RF_LICENSE_KEY is set and your subscription is active. RF_DEBUG=1 will show the activation result; missing key, expired subscription, network failure, or no JWT cache all skip PDF generation.

Full guide: reportforge.org/docs#troubleshooting.

Documentation

Full documentation at reportforge.org/docs:

• Quick start — install, configure, activate
• Chrome setup — Windows, Linux, macOS
• CI/CD integration — GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins, Azure DevOps
• Configuration reference — all options
• Filename tokens — {date}, {branch}, {status}
• Templates — minimal, detailed, executive
• License & offline behaviour — JWT cache, machine cap, cancellation
• Troubleshooting — common issues and debug flags
• Changelog — CHANGELOG.md

Contributing

Questions and bug reports: email [email protected].

License

MIT — see LICENSE.