wcag-a11y 0.4.1 → 0.4.2

package/README.md

@@ -78,8 +78,13 @@ npm install -g wcag-a11y
 ## Quick start
 
 ```bash
-# 1. Configure your AI provider (Gemini is free, no credit card)
-wcag-a11y init
+# 1. Configure your AI provider and framework (Gemini is free, no credit card)
+wcag-a11y init --framework next      # Next.js
+wcag-a11y init --framework react     # React / Vite
+wcag-a11y init --framework vue       # Vue / Nuxt
+wcag-a11y init --framework angular   # Angular
+wcag-a11y init --framework svelte    # Svelte / SvelteKit
+wcag-a11y init                       # plain HTML or auto-detect
 
 # 2. Start your dev server, then scan
 wcag-a11y scan -u http://localhost:3000
@@ -116,6 +121,7 @@ wcag-a11y scan -u http://localhost:3000 --terminal --fast-mode
 | `--group <strategy>` | `rule` | `rule`: one prompt per rule type. `none`: one prompt per element |
 | `--ci` | off | Exit with code `1` if any violations are found |
 | `--provider <name>` | from config | Override AI provider for this run |
+| `--framework <name>` | from config | Override framework for this run (e.g. `next`, `react`, `vue`, `angular`, `svelte`, `astro`) |
 
 ---
 
@@ -159,21 +165,28 @@ wcag-a11y fix --from-report --apply       # patches files from that report, no s
 | `--from-report [path]` | `a11y-report.md` | Load violations from an existing report instead of rescanning |
 | `--apply` | off | Write fixes to disk (dry-run without this flag) |
 | `--provider <name>` | from config | Override AI provider for this run |
+| `--framework <name>` | from config | Override framework for this run (e.g. `next`, `react`, `vue`, `angular`, `svelte`, `astro`) |
 
 ---
 
 ### `wcag-a11y init`
 
-Create `a11y.config.json` pre-configured for your chosen provider.
+Create `a11y.config.json` pre-configured for your chosen provider and framework.
 
 ```bash
-wcag-a11y init                          # Gemini (free, default)
-wcag-a11y init --provider openai
-wcag-a11y init --provider anthropic
-wcag-a11y init --provider ollama        # local — no API key needed
-# … and 8 more providers
+wcag-a11y init                                      # Gemini (free, default)
+wcag-a11y init --provider openai --framework next   # OpenAI + Next.js
+wcag-a11y init --provider ollama --framework react  # local Ollama + React
+# … 12 providers total, any framework string accepted
 ```
 
+| Flag | Description |
+|---|---|
+| `--provider <name>` | AI provider. Default: `gemini`. See [AI Providers](#ai-providers) for all options |
+| `--framework <name>` | Your project framework — saved to config so every scan uses it automatically |
+
+Framework is saved as `"framework"` in `a11y.config.json`. You can also edit the file directly at any time. Supported values for best results: `next`, `react`, `vue`, `nuxt`, `angular`, `svelte`, `gatsby`, `remix`, `astro` — or any free-form string.
+
 ---
 
 ### `wcag-a11y demo`
@@ -217,7 +230,8 @@ Run `wcag-a11y init` to generate `a11y.config.json`. Only fill in the fields for
 ```json
 {
   "provider": "gemini",
-  "apiKey": "YOUR_GEMINI_API_KEY"
+  "apiKey": "YOUR_GEMINI_API_KEY",
+  "framework": "next"
 }
 ```
 

package/dist/cli.js

@@ -13,13 +13,14 @@ const program = new Command();
 program
     .name('wcag-a11y')
     .description('WCAG 2.1/2.2 accessibility auditor with AI-powered fixes')
-    .version('0.4.1');
+    .version('0.4.2');
 program
     .command('init')
     .description('Create a11y.config.json in the current directory')
     .option('--provider <name>', 'AI provider to configure (gemini|openai|ollama|anthropic|mistral|groq|cohere|xai|deepseek|together|perplexity|azure-openai)', 'gemini')
+    .option('--framework <name>', 'Your project framework — saves to config so every run uses it automatically (e.g. next, react, vue, angular, svelte, astro)')
     .action((opts) => {
-    initConfig(opts.provider);
+    initConfig(opts.provider, opts.framework);
 });
 program
     .command('scan')
@@ -35,10 +36,11 @@ program
     .option('--group <strategy>', 'Group violations by rule or show individually (rule|none)', 'rule')
     .option('--ci', 'Exit with code 1 if any violations are found (for CI/CD pipelines)', false)
     .option('--provider <name>', 'Override the AI provider from config (gemini|openai|ollama|anthropic|mistral|groq|cohere|xai|deepseek|together|perplexity|azure-openai)')
+    .option('--framework <name>', 'Override framework detection for this run (e.g. next, react, vue, angular, svelte, astro)')
     .action(async (opts) => {
     try {
         console.log(`\nScanning ${opts.url}...`);
-        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl });
+        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl, framework: opts.framework });
         if (opts.terminal && !opts.fastMode) {
             printTerminalReport(result);
         }
@@ -51,10 +53,11 @@ program
             const provider = createAIProvider(config);
             const allViolations = result.pages.flatMap((p) => p.violations);
             const ruleGroups = groupViolations(allViolations, strategy);
+            const framework = result.framework ?? config.framework;
             if (!opts.fastMode) {
                 console.log(`\nGenerating AI fixes for ${ruleGroups.length} rule groups (${allViolations.length} violations)...`);
             }
-            const fixes = await provider.generateFixes(allViolations, strategy, result.framework);
+            const fixes = await provider.generateFixes(allViolations, strategy, framework);
             if (opts.terminal) {
                 printAIPrompts(fixes, { explain: opts.explain, fastMode: opts.fastMode });
             }
@@ -83,6 +86,7 @@ program
     .option('--from-report [path]', 'Use an existing report instead of scanning (default: a11y-report.md)')
     .option('--apply', 'Write fixes to source files (default: dry-run, shows diff only)', false)
     .option('--provider <name>', 'Override the AI provider from config (gemini|openai|ollama|anthropic|mistral|groq|cohere|xai|deepseek|together|perplexity|azure-openai)')
+    .option('--framework <name>', 'Override framework detection for this run (e.g. next, react, vue, angular, svelte, astro)')
     .action(async (opts) => {
     if (!opts.url && !opts.fromReport) {
         console.error('\nError: provide --url <url> to scan, or --from-report [path] to load an existing report.');
@@ -104,6 +108,7 @@ program
             apply: opts.apply,
             provider,
             srcDir: resolve(process.cwd(), 'src'),
+            framework: opts.framework ?? config.framework,
         });
     }
     catch (err) {

package/dist/config.js

@@ -82,13 +82,14 @@ const STARTER_CONFIGS = {
         `Created ${CONFIG_FILE} — fill in your Azure OpenAI endpoint, deployment, and API key from https://portal.azure.com`,
     ],
 };
-export function initConfig(provider = 'gemini') {
+export function initConfig(provider = 'gemini', framework) {
     const configPath = join(process.cwd(), CONFIG_FILE);
     if (existsSync(configPath)) {
         console.log(`${CONFIG_FILE} already exists.`);
         return;
     }
     const [starter, message] = STARTER_CONFIGS[provider];
-    writeFileSync(configPath, JSON.stringify(starter, null, 2));
+    const config = framework ? { ...starter, framework } : starter;
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
     console.log(message);
 }

package/dist/crawler.js

@@ -61,7 +61,7 @@ export async function crawl(options) {
             }
         }
         const results = [];
-        let framework;
+        let framework = options.framework;
         for (const pageUrl of pagesToVisit) {
             const page = await context.newPage();
             try {

package/dist/fixer.js

@@ -18,11 +18,12 @@ export async function runFix(opts) {
             console.log(chalk.green('\nNo violations found in report.'));
             return;
         }
+        framework = opts.framework;
         console.log(`Found ${allViolations.length} violation(s) in report. Locating source files...\n`);
     }
     else {
         console.log(`\nScanning ${opts.url}...`);
-        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl });
+        const result = await crawl({ url: opts.url, pages: opts.pages, crawl: opts.crawl, framework: opts.framework });
         framework = result.framework;
         if (result.totalViolations === 0) {
             console.log(chalk.green('\nNo violations found.'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wcag-a11y",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "WCAG 2.1/2.2 accessibility auditor with AI-powered fixes. Crawls your dev server with Playwright, runs 40+ checks, and uses AI (12 providers) to generate fix prompts or patch source files directly.",
   "keywords": [
     "wcag",