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/surjectionSurjection 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
| Feature | Free | Pro |
|---|---|---|
| Playwright helper, Vitest matcher and CLI | Included | Included |
| WCAG 2.2 and EN 301 549 mapping | Included | Included |
| Baseline for existing sites | Included | Included |
| Markdown report and accessibility statement in five languages | Included | Included |
| Accessible React building blocks | Included | Included |
| Client report in your branding (HTML, PDF, Word), conformance report and ACR | Not included | Included |
| History and dashboard across client projects | Not included | Included |
| Pull request comment with new issues and scheduled monitoring with Slack or mail alerts (beta) | Not included | Included |
| Manual WCAG 2.2 checklist with browser editor | Not included | Included |
| Licence | MIT | Per person |
| Support | GitHub issues | Agency and Lifetime |
Pro
Pro packagesAdd-ons on top of the core.
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-reportClient 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-historyRecords 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-checklistThe 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
Agency
RecommendedFor teams of up to ten named people, one price.
CHF 590
per year
2 months free
- Up to 10 people
- Support included
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
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.
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.
2026-10-13
Compliance Bundle 2.0: all five packages on 2.0, plus new Pro extensionsPermito, Surjection, Logarithm, Inverse and Witness are on 2.0, for free and Pro. Pro 2.1 adds a case inbox and monitoring for Inverse, a Consent Mode check for Permito and pull request comments for Surjection, all marked beta. Prices stay as they are.
2026-10-05
The Compliance Bundle: three Pro add-ons, one licencePermito Pro, Surjection Pro and Logarithm Pro together from CHF 49 a month. New compliance packages join at no extra cost. Also: new prices for Cosine Pro and Derivative Pro.