Reports
Render an accessibility report, a performance budget, and the WCAG checklist from site data.
The three report components turn the files the gates write into a page. They read one value from
site.data, render plain server-side HTML, and add no client script: the whole report is readable
without JavaScript.
Every component shows a visible note naming the missing file when the data is absent, so a page never reads as a clean pass because a gate did not run. A report is checked field by field before it is shown; a row with no usable value is left out.
a11y-report
The accessibility gate's report: the matrix it audited, every finding by impact, the known findings that are still open, and the keyboard and no-JavaScript journeys with their result.
Accessibility report
The gate audited 3 page states. Commit: 0123456
Tools: node v24.0.0 · playwright 1.65.0 · axe 4.14.0 · chromium 140.0.0
Rules run: wcag2a, wcag2aa, wcag21a, wcag21aa, wcag22aa
Page states
| Case | Layout | Language | Theme |
|---|---|---|---|
| example home | home | en | light |
| example home | home | en | dark |
| example persian | doc | fa | light |
Findings
| Impact | Count |
|---|---|
| critical | 0 |
| serious | 0 |
| moderate | 1 |
| minor | 0 |
| Case | Theme | Impact | Rule | Element | What the rule checks |
|---|---|---|---|---|---|
| example home | light | moderate | color-contrast | .example-eyebrow | Elements must meet minimum color contrast ratio thresholds |
Known findings that are still open
| Case | Theme | Rule | Element |
|---|---|---|---|
| Every page | dark | region | main |
Keyboard and no-JavaScript journeys
| Journey | Theme | Result |
|---|---|---|
| open the navigation | light | passed |
| read without JavaScript | dark | passed |
Options
from— the/-separated path insite.datathat holds the report, so a key with a dot in it stays one segment (reports/0.3.0/a11y). Default:accessibility-report.
budget-report
The performance budget's report: measured bytes per route and asset class, the checked-in budget, and the JavaScript and CSS totals per route.
Performance report
Measured 2 routes. Commit: 0123456 gzip tolerance 64 B per asset class
Bytes per route and asset class
| Route | Asset class | Files | Raw | gzip | Budget (gzip) | State | |
|---|---|---|---|---|---|---|---|
/ | css/base | 1 | 18,400 B | 5,100 B | 5,200 B (1) | within the budget | |
/ | css/page | 1 | 2,200 B | 900 B | 900 B (1) | within the budget | |
/ | js/chrome | 3 | 21,000 B | 7,200 B | 7,200 B (3) | within the budget | |
/guide/ | css/base | 1 | 18,400 B | 5,100 B | 5,200 B (1) | within the budget | |
/guide/ | css/page | 1 | 3,100 B | 1,200 B | 1,200 B (1) | within the budget | |
/guide/ | js/chrome | 3 | 21,000 B | 7,200 B | 7,200 B (3) | within the budget |
JavaScript and CSS per route
| Route | JavaScript | CSS | Targets |
|---|---|---|---|
/ | 7,200 B | 6,000 B | No target given |
/guide/ | 7,200 B | 6,300 B | No target given |
Options
from— the/-separated path insite.datathat holds the report. Default:performance-report.targets— optional per-route limits in gzip bytes, as{"js":20000,"css":15000}orjs=20000,css=15000. A route over a limit says so in words; no route is hidden.
wcag-checklist
Every WCAG 2.2 level A and AA success criterion, grouped by principle, with how it is checked and the evidence behind a manual check. Each row links to the W3C's Understanding page instead of copying the criterion.
WCAG 2.2 A and AA checklist
55 criteria: 13 automated, 27 manual, and 15 not applicable.
Perceivable
| Criterion | Level | Checked by | What is checked | Checked |
|---|---|---|---|---|
1.1.1 Non-text Content | A | automated | axe checks that a text alternative exists; a person still reads whether it is meaningful. | |
1.2.1 Audio-only and Video-only (Prerecorded) | A | not applicable | The theme ships no prerecorded audio or video of its own; media is embedded from a provider. | |
1.2.2 Captions (Prerecorded) | A | not applicable | Captions belong to the embedded media's source, which the theme does not host. | |
1.2.3 Audio Description or Media Alternative (Prerecorded) | A | not applicable | The theme hosts no prerecorded media and writes no audio description. | |
1.2.4 Captions (Live) | AA | not applicable | The theme hosts no live media. | |
1.2.5 Audio Description (Prerecorded) | AA | not applicable | The theme hosts no prerecorded media and writes no audio description. | |
1.3.1 Info and Relationships | A | automated | List, table, and ARIA parent-child structure. | |
1.3.2 Meaningful Sequence | A | manual | A person follows the reading order with a screen reader. | not recorded yet |
1.3.3 Sensory Characteristics | A | manual | No instruction relies on shape, size, position, or sound; a person reads each one. | not recorded yet |
1.3.4 Orientation | AA | manual | The layout does not lock orientation; a person checks both orientations. | not recorded yet |
1.3.5 Identify Input Purpose | AA | not applicable | The only form is the variables demo, which asks for no personal data. | |
1.4.1 Use of Color | A | automated | Links in text are underlined or otherwise marked, not told apart by colour alone. | |
1.4.2 Audio Control | A | not applicable | The theme plays no audio. | |
1.4.3 Contrast (Minimum) | AA | automated | Rendered text is checked at 4.5:1 (3:1 for large text) in light and dark; a person also reads it. | |
1.4.4 Resize Text | AA | manual | axe catches a viewport that blocks zoom; a person also checks the layout at 200%. | · 0.2.2 · evidence |
1.4.5 Images of Text | AA | manual | Headings and interface text are real text; a person checks that no image replaces them. | not recorded yet |
1.4.10 Reflow | AA | manual | Checked at a 320 px wide window: nothing may scroll sideways. | · 0.2.2 · evidence |
1.4.11 Non-text Contrast | AA | manual | Focus rings and interface marks are checked at 3:1. | not recorded yet |
1.4.12 Text Spacing | AA | manual | axe catches inline styles that block spacing overrides; a person also checks the result. | not recorded yet |
1.4.13 Content on Hover or Focus | AA | manual | Popovers open on focus and close with Escape. | not recorded yet |
Operable
| Criterion | Level | Checked by | What is checked | Checked |
|---|---|---|---|---|
2.1.1 Keyboard | A | manual | axe finds scroll regions that cannot take focus; a person also operates every control. | · 0.2.2 · evidence |
2.1.2 No Keyboard Trap | A | manual | The drawer and the search palette trap focus only while open and return it on close. | · 0.2.2 · evidence |
2.1.4 Character Key Shortcuts | A | manual | The site's single-key shortcuts are disabled by default in unmodified form and can be turned off. | not recorded yet |
2.2.1 Timing Adjustable | A | not applicable | The theme sets no time limit on reading or on a task. | |
2.2.2 Pause, Stop, Hide | A | manual | The announcement bar is the only moving content and it can be dismissed. | not recorded yet |
2.3.1 Three Flashes or Below Threshold | A | not applicable | The theme flashes nothing. | |
2.4.1 Bypass Blocks | A | automated | A skip link is the first stop. | |
2.4.2 Page Titled | A | automated | Every page has a title from its front matter, its first heading, or its file name. | |
2.4.3 Focus Order | A | manual | A person checks which element has focus at each step. | not recorded yet |
2.4.4 Link Purpose (In Context) | A | automated | Every link has text that names where it goes. | |
2.4.5 Multiple Ways | AA | manual | The site offers navigation, search, and a sitemap; a person checks more than one way is present. | not recorded yet |
2.4.6 Headings and Labels | AA | automated | Headings and labels describe their topic. | |
2.4.7 Focus Visible | AA | manual | A person checks that the focus ring is visible at each step. | · 0.2.2 · evidence |
2.4.11 Focus Not Obscured (Minimum) | AA | manual | The sticky header and sidebar are checked against a focused link. | not recorded yet |
2.5.1 Pointer Gestures | A | not applicable | No control needs a multipoint or path-based gesture. | |
2.5.2 Pointer Cancellation | A | manual | Every action fires on release, and a person checks the pointer journeys. | not recorded yet |
2.5.3 Label in Name | A | automated | A control's visible label is part of its accessible name. | |
2.5.4 Motion Actuation | A | not applicable | No control responds to device motion. | |
2.5.7 Dragging Movements | AA | not applicable | No control is dragged. | |
2.5.8 Target Size (Minimum) | AA | automated | Interactive targets meet the 24 by 24 CSS pixel minimum or have an equivalent control. |
Understandable
| Criterion | Level | Checked by | What is checked | Checked |
|---|---|---|---|---|
3.1.1 Language of Page | A | automated | Every page sets lang and dir; the Persian and Arabic pages are in the matrix. | |
3.1.2 Language of Parts | AA | manual | Mixed-direction text is isolated; a person checks the wording. | not recorded yet |
3.2.1 On Focus | A | manual | Focus alone changes nothing; a person tabs through every control. | not recorded yet |
3.2.2 On Input | A | manual | Changing a field or a choice runs no navigation; a person checks the forms. | not recorded yet |
3.2.3 Consistent Navigation | AA | manual | One layout renders the navigation on every page. | not recorded yet |
3.2.4 Consistent Identification | AA | manual | The same control keeps the same name and icon across pages. | not recorded yet |
3.2.6 Consistent Help | A | manual | The theme offers no help mechanism of its own; a site that adds one places it consistently. | not recorded yet |
3.3.1 Error Identification | A | manual | The variables demo names the field and shows a visible localized error. | · 0.2.2 · evidence |
3.3.2 Labels or Instructions | A | automated | Every input has a label or instructions. | |
3.3.3 Error Suggestion | AA | manual | The variables demo says what a value must look like. | not recorded yet |
3.3.4 Error Prevention (Legal, Financial, Data) | AA | not applicable | The theme takes no legal, financial, or personal-data transaction. | |
3.3.7 Redundant Entry | A | not applicable | The theme has no multi-step form that could ask for the same information twice. | |
3.3.8 Accessible Authentication (Minimum) | AA | not applicable | The theme has no authentication. |
Robust
| Criterion | Level | Checked by | What is checked | Checked |
|---|---|---|---|---|
4.1.2 Name, Role, Value | A | automated | axe checks names, roles, and ARIA state; a person also checks the behaviour. | |
4.1.3 Status Messages | AA | manual | Status messages are announced without moving focus; a person checks the copy and form messages. | · 0.2.2 · evidence |
Options
from— the/-separated path insite.datathat holds the criteria. Default:wcag.
Where the data comes from
scripts/test-a11y.ts --report <file> writes the accessibility report and
scripts/performance-budget.ts --report <file> writes the performance report; both validate their
file against a schema in schema/ before writing it. The site deploy writes the current reports into
site/_data/ before the build, and the repository keeps one copy per release under
site/_data/reports/; docs/release.md gives the archive command. The checklist is authored in site/_data/wcag.yml.