Skip to main content
Introducing packages.sweber.dev
All packages
StableMIT + Pro

SurjectionAccessibility checks for CI and tests, client-ready reports and accessibility statements in five languages. Built on axe-core, no overlay.

pnpm add -D @sweberdev/surjection

Surjection helps agencies make accessibility part of every project instead of a one-off scan. It runs axe-core in Playwright and Vitest, maps every finding to WCAG 2.2 and EN 301 549, and fails the build only on new problems thanks to a baseline for existing sites.

It also generates the accessibility statement (Erklärung zur Barrierefreiheit) in German, Swiss German, French, Italian and English, and ships small accessible React building blocks. Surjection is deliberately not an overlay widget: it helps you fix the code, it does not hide problems. Automated tests find only part of all barriers, so Surjection does not promise legal conformity.

Example

A short exampleCopy it into your project.

tests/a11y.spec.ts

import { test } from "@playwright/test"
import { expectAccessible } from "@sweberdev/surjection/playwright"
import baseline from "./a11y-baseline.json"

for (const path of ["/", "/shop", "/checkout"]) {
  test(`${path} is accessible`, async ({ page }) => {
    await page.goto(path)
    await expectAccessible(page, { baseline, failOn: "serious", locale: "de" })
  })
}

Features

What you getFree under MIT, with Pro on top.

Free, MIT

  • axe-core checks for Playwright and Vitest, mapped to WCAG 2.2 and EN 301 549
  • CLI for whole sites, baseline for existing sites, SARIF and JUnit
  • Layout, keyboard, login, state and flow checks
  • Markdown reports for pull requests
  • Accessibility statement generator in 5 languages

Pro

  • Everything in Free
  • Client reports in your branding as HTML, PDF and Word
  • WCAG-EM conformance report and accessibility conformance report
  • Fix list as CSV for Excel
  • History across all client projects with regression monitoring
  • Guided manual checklist for what automation cannot test
All features in detail

Free, MIT

  • Playwright helper and Vitest matcher on top of axe-core, tested against WCAG 2.2 AA by default
  • Every finding mapped to its WCAG success criterion and EN 301 549 clause
  • Baseline for existing sites: CI fails only on new issues, not on the whole backlog
  • CLI for whole sites: sitemap with up to 8 pages at once (600 pages in 90 seconds), desktop or mobile viewport, JUnit XML for GitLab, Azure DevOps and Jenkins
  • surjection init sets up a config file and a GitHub Actions workflow in one command
  • Layout check: reflow at 320 px (1.4.10) and text spacing (1.4.12), which axe-core cannot decide
  • Keyboard check: finds focus traps, missing focus indicators and a jumping focus order by pressing Tab through each page
  • Checks pages behind a login with a saved Playwright session, in light or dark colour scheme and with reduced motion
  • States: opened menus, dialogs and forms are checked after a few click steps, each as its own page in reports and baseline
  • Flows: a multi-step journey such as a checkout is checked after every step you choose, each check as its own page in reports and baseline
  • Screenshots of every affected element, saved next to the results; --compare-with adds before and after images of what was fixed
  • SARIF 2.1.0 and JUnit output, plus a JSON schema for the config file with completion in your editor
  • Markdown report for pull requests and job summaries, in German, Swiss German, French, Italian and English
  • Accessibility statement generator (DE, DE-CH, FR, IT, EN) as Markdown and HTML, derived directly from the Pro checklist if you use it
  • Accessible React building blocks: skip link, visually hidden text, live announcements, reduced motion
  • surjection coverage: which of the 55 WCAG 2.2 A/AA criteria are tested automatically, derived from the installed rule set
  • Component checks for Storybook and Testing Library through @sweberdev/surjection/component

Pro

  • Client reports in your agency's branding, as HTML, PDF and editable Word document, with a screenshot of every affected element as evidence and a before and after image of everything you fixed since the last report
  • WCAG-EM conformance report (HTML, PDF, Word) with the outcome per criterion, sample, EN 301 549 clause and evidence, and an ACR export with the usual conformance levels; neither promises legal conformity
  • Fix list as CSV for Excel: one row per element, with status and note columns for your developers
  • History across all client projects, so you can show progress over time, with a status badge per project and a nightly check that tells you what got worse, by webhook (Slack, Teams, Discord) or mail
  • Re-test only what was affected: pages, states and flows with findings, merged back into the earlier results and the checklist
  • Guided manual checklist for the criteria automated tests cannot cover, in German, Swiss German, English, French and Italian, with evidence (links, screenshots) and reviewer for every criterion
FeatureFreePro
Playwright helper, Vitest matcher and CLIIncludedIncluded
WCAG 2.2 and EN 301 549 mappingIncludedIncluded
Baseline for existing sitesIncludedIncluded
Markdown report and accessibility statement in five languagesIncludedIncluded
Accessible React building blocksIncludedIncluded
Client report in your branding (HTML, PDF, Word), conformance report and ACRNot includedIncluded
History and dashboard across client projectsNot includedIncluded
Pull request comment with new issues and scheduled monitoring with Slack or mail alerts (beta)Not includedIncluded
Manual WCAG 2.2 checklist with browser editorNot includedIncluded
LicenceMITPer person
SupportGitHub issuesAgency and Lifetime

Pro

Pro packagesAdd-ons on top of the core.

Live demo

Try the themes, browse the catalog and read a real scanner report. The demo also shows the GTM container check, the monitoring of many client sites and the catalog changes per project.

  • @weber-development/surjection-report

    Client reports in your branding as HTML, PDF and Word, plus a fix list as CSV, a WCAG-EM conformance report and an ACR export, in German, Swiss German, French, Italian and English.

  • @weber-development/surjection-history

    Records every run per project and renders a dashboard with status, change and trend, plus an SVG status badge per project and a regression check. New in 2.1 (beta): a sticky pull request comment with only the new issues, and a daily monitoring workflow that notifies by Slack webhook or mail when results get worse. Re-tests only the pages with findings.

  • @weber-development/surjection-checklist

    The 55 WCAG 2.2 A/AA criteria with instructions for manual testing in five languages, a browser editor and export to the statement.

Pricing

PricingPrices are in CHF.

Surjection Pro is also part of the Compliance Bundle. See the Compliance Bundle

Freelancer

For one person working on client projects.

CHF 190

per year

2 months free

  • 1 person
  • No support entitlement
Subscribe

Agency

Recommended

For teams of up to ten named people, one price.

CHF 590

per year

2 months free

  • Up to 10 people
  • Support included
Subscribe

Lifetime

Pay once for up to ten people and keep updates and repository access.

CHF 1’990

one-time

  • Up to 10 people
  • Support included
Buy lifetime licence

11 people or more: get in touch

  • After cancelling, every version you already received keeps working. Only updates and repository access end.
  • No licence key, no phone-home. The packages never contact a server to check your licence.
  • Agency and Lifetime cover up to ten named people for one price: you choose the number of seats at checkout and assign them in Polar. Your clients and their websites need no licence of their own.
  • Checkout, invoices and VAT are handled by Polar as merchant of record.
Read the licence terms

FAQ

QuestionsShort answers.

Is Surjection 2.0 stable?

Yes. The documented API, the command line options, the config file, the formats of the results, baseline and checklist files and the ids of Surjection's own rules follow semantic versioning, and the Pro packages share the version. Within 2.x nothing of that is removed. What can change in any release: which problems the checks find, because axe-core is updated and finds more, and the texts of reports. Version 1.x gets security and bug fixes for 12 months after the release of 2.0.0. The stability page in the docs lists both.

Does Surjection make my website legally compliant?

No tool can promise that. Automated tests detect only part of all barriers. Surjection makes testing and documentation part of your workflow, but a manual review is still needed.

Is this an accessibility overlay?

No. Overlays add a widget on top of a site and leave the code unchanged. Surjection runs in development and CI and helps you fix the code itself.

Who needs a licence?

Every person on your team who works with the Pro packages. Freelancer covers one person. Agency and Lifetime cover up to ten named people for the same price: you pick the number of seats at checkout, assign them in Polar, and each person connects their own GitHub account. For eleven or more, get in touch.

What happens when I cancel?

Every version you already received keeps working, in every project you used it in. Only new updates and access to the private repository end.

Do my clients need their own licence?

No. The licence covers the people building the sites. The websites you deliver and the clients who own them need nothing.

Is there a licence key or usage tracking?

No. The packages are installed from a private GitHub Packages registry and never contact a licence server.

Who issues the invoice, and is VAT included?

Polar sells Surjection Pro as merchant of record. It handles checkout, invoices and VAT for your country.

Can I use the open-source part on its own?

Yes. @sweberdev/surjection and @sweberdev/surjection-react are MIT-licensed and complete without Pro.

Articles

ArticlesGuides and release notes.