Free shipping on orders over $50.
\n```\n\n**Why it matters:**\nUsers with low vision or color blindness cannot distinguish this text from its\nbackground; the text becomes difficult or impossible to read.\n\n**📋 Prompt for your AI assistant (Cursor / Copilot / Claude):**\n```\nFix WCAG 2.1 SC 1.4.3 (Level AA) — Text must have a contrast ratio of at least 4.5:1\n\nAffected element:\n- Selector: `#main > p`\n\nCurrent HTML:\nFree shipping on orders over $50.
\n\nHow to fix:\nDarken the text color to meet 4.5:1 contrast.\nExample: change `color: #aaa` to `color: #767676` (minimum passing value).\n```\n\n---\n\n### 🔴 [CRITICAL] Buttons must have an accessible name\n\n**Rule:** `button-name`\n**WCAG:** WCAG 2.1 SC 4.1.2\n**Instances:** 1\n\n**Representative element:**\n`#main > section > form > button`\n```html\n\n```\n\n**Why it matters:**\nScreen reader users hear only \"button\" with no label — they cannot tell what\nthe button does without exploring the surrounding content visually.\n\n**📋 Prompt for your AI assistant (Cursor / Copilot / Claude):**\n```\nFix WCAG 2.1 SC 4.1.2 (Level A) — Buttons must have an accessible name\n\nAffected element:\n- Selector: `#main > section > form > button`\n\nCurrent HTML:\n \n\nHow to fix:\nAdd visible text content or aria-label to the button.\nExample: \n or \n```\n\n... 3 more violations with prompts\n~~~\n\n---\n\n## Install\n\n```bash\nnpm install -g wcag-a11y\n```\n\n## Quick start\n\n```bash\n# 1. Configure your AI provider (Gemini is free, no credit card)\nwcag-a11y init\n\n# 2. Start your dev server, then scan\nwcag-a11y scan -u http://localhost:3000\n```\n\nAdd `--pages / /about /contact` to scan specific routes, or `--crawl` to follow links automatically.\n\n**Optional — set your framework once:** The tool auto-detects common frameworks at runtime. If detection fails (e.g. scanning a staging URL, or using Astro/SvelteKit), set it in your config so every run uses the right syntax:\n\n```bash\nwcag-a11y init --framework next # or react, vue, angular, svelte, astro, …\n```\n\n---\n\n## Commands\n\n### `wcag-a11y scan`\n\nScan a running dev server for accessibility violations.\n\n```bash\nwcag-a11y scan -u http://localhost:3000\nwcag-a11y scan -u http://localhost:3000 --pages / /about /contact\nwcag-a11y scan -u http://localhost:3000 --crawl\nwcag-a11y scan -u http://localhost:3000 --no-ai --ci\nwcag-a11y scan -u http://localhost:3000 --terminal --fast-mode\n```\n\n| Flag | Default | Description |\n|---|---|---|\n| `-u, --url