1.1 KiB
Document the scripts directory utilities for development workflows
Overview
The scripts/ directory contains 14 utility scripts that are completely undocumented: optimize-images.js/mjs (image optimization), generate-blog-images.mjs (AI image generation with --dry-run flag), lighthouse-audit-all-locales.js (Lighthouse testing), axe-accessibility-audit.js (accessibility testing), pagespeed-check.js (PageSpeed API), generate-sitemap.js, convert-translations.js, download-fonts.js/mjs, generate-icons.mjs/generate-icons-simple.mjs, generate-github-readme.js. Package.json only documents 3 of these scripts.
Rationale
These scripts represent significant development tooling investments that could save developers hours of work. The image generation script uses OpenAI API but this isn't obvious without reading the code. Accessibility and performance audit scripts (axe, lighthouse, pagespeed) exist but developers wouldn't know to use them. The package.json only exposes 3 scripts but 14 exist.
This spec was created from ideation and is pending detailed specification.