Open source · Accessibility

SVG Semantic Layout Auditor

Check SVG names, references, dimensions and possible text overflow before release, then confirm the rendered result in browsers and assistive technology.

Experimental · v0.1.0 · Node.js 20+ · MIT

View v0.1.0 release · Browse source code

Run the public SVG fixtures

Clone the repository, use Node.js 20 or newer, and run these commands from its root. Both inputs are synthetic and checked in.

Clean labelled diagram

node ./src/cli.js examples/accessible-card.svg --format json --no-timestamp

The released CLI reports zero findings for this fixture.

Inspect the clean SVG source · Inspect its JSON report

Intentionally problematic SVG

node ./src/cli.js examples/problematic.svg --format json --no-timestamp --fail-on none

The intentionally problematic public fixture reports eight findings: two errors and six warnings. Six are static document checks; two estimated text-layout warnings need visual confirmation.

--fail-on none collects this example without failing the command; it does not make the SVG safe.

Inspect the failing SVG source

Clean public SVG example showing three labelled stages: Validate, Process and Deliver
The public accessible-card.svg fixture has a title, description and three labelled stages. The v0.1.0 CLI reports zero findings for it.

What the report can prove

The auditor reads local SVG files without executing them or making network requests. A static check does not replace browser, screen-reader, keyboard or visual testing, and it does not certify WCAG conformance. Estimated layout findings model text width without loading fonts; treat them as review prompts, not measured overflow.

Read the exact rule definitions

The three check families

Semantic naming, reference safety and text-layout estimates are separate questions. A passing static check still needs a rendered accessibility review.

Conceptual Edilec illustration of the SVG Semantic Layout Auditor checking SVG accessibility, references and layout
Conceptual illustration of the rule groups, not a browser rendering or tool report.

Continue the review

Make SVG review part of a web release

Discuss an accessible web workflow with Edilec. Share only materials you are permitted to disclose.

Discuss an accessible web workflow