Ignore system

Every a11y tool has false positives. Equall lets you suppress them via comments directly in the source, so the suppression lives with the code, not in a separate config.

Inline: ignore a single line

Add a comment on the line immediately above the offending element:

{/* equall-ignore-next-line */}
<div onClick={handler}>Click me</div>

All issues on the next line are ignored.

Inline: ignore a specific rule

Add the rule ID after equall-ignore-next-line:

{/* equall-ignore-next-line jsx-a11y/click-events-have-key-events */}
<div onClick={handler}>Click me</div>

Only that rule is suppressed — other issues on the same line still surface.

File-level ignore

Add a comment in the first 5 lines of the file to suppress every issue in it:

// equall-ignore-file

Useful for generated code or vendored files.

Managing ignores with the CLI

equall ignore --list                                   # list all ignores in the project
equall ignore src/Modal.tsx:89                         # add ignore at file:line
equall ignore src/Modal.tsx:89 jsx-a11y/alt-text       # scope to a rule
equall ignore src/generated.tsx                        # file-level ignore
equall ignore --remove src/Modal.tsx:89                # remove a specific ignore
equall ignore --clear                                  # remove every ignore in the project

How ignored issues appear in output

Ignored issues are excluded from scoring but still shown in the terminal output (with a muted marker) for transparency. Pass --show-ignored to see the full list explicitly, or --json to include them in machine-readable output with ignored: true.

When NOT to ignore

An ignore comment is a statement that you've considered the issue and decided it's a false positive. Use it when:

• The rule is structurally wrong for your component (e.g. a button styled as a link)
• The issue requires runtime context the scanner can't see (e.g. ARIA labels coming from an upstream library)

Do not use it to silence issues you haven't understood. A review of your ignore list is a valid pre-release check.