When working on a task that touches this area, read the relevant file — don't load all of them.
| Topic | File | When to read |
|---|---|---|
| Overview and quick start (human-readable) | README.md | Onboarding, getting oriented |
| Visual design, colours, typography, headings | design-system.md | Creating/modifying UI, visual decisions |
| Buttons, cards, forms, spacing, responsive | design-components.md | Building specific components |
| WCAG, ARIA, landmarks, keyboard nav | accessibility.md | Any interactive element or layout change |
| Screen readers, contrast, testing checklist | accessibility-testing.md | Validating accessibility |
| TypeScript rules, script tag patterns | typescript.md | Writing/fixing TypeScript or inline scripts |
| Tailwind approach, section backgrounds, waves | styling.md | CSS/layout work, section rhythm |
| UK English, tone, capitalisation rules | content-guidelines.md | Writing user-facing content |
| Metadata, SEO, blog posts, images | content-metadata.md | Adding pages, blog posts, or metadata |
| Alpine.js progressive enhancement | alpine.md | Interactive components with Alpine |
| Content collections, image utilities | content.md | Working with Astro content or images |
| Project structure, build process, commands | development.md | Build issues, project overview |