Skip to content

Add comprehensive SEO, accessibility, and performance documentation#44

Merged
dinooo13 merged 3 commits into
mainfrom
claude/update-docs-standards-yWPK0
May 9, 2026
Merged

Add comprehensive SEO, accessibility, and performance documentation#44
dinooo13 merged 3 commits into
mainfrom
claude/update-docs-standards-yWPK0

Conversation

@dinooo13
Copy link
Copy Markdown
Owner

@dinooo13 dinooo13 commented May 9, 2026

Summary

This PR significantly expands the project documentation in CLAUDE.md and README.md to establish clear guidelines for SEO, accessibility, and performance standards. It also updates the project structure documentation to reflect recent additions like the OG image template and SEO module integration.

Key Changes

  • SEO & Structured Data: Added detailed section covering @nuxtjs/seo integration, JSON-LD/schema-org patterns, and requirements for every page (canonical URLs, OG images, structured data)
  • Performance Guidelines: New section with strict rules for animations (CSS-only, transform-only, prefers-reduced-motion support), image optimization (loading, fetchpriority, sizes, densities), and build configuration
  • Accessibility Standards: Comprehensive WCAG 2.1 AA compliance guidelines covering:
    • Landmark roles and skip navigation patterns
    • Semantic HTML structure (nav, ul, li for link groups)
    • Interactive element ARIA attributes (aria-expanded, aria-controls)
    • Screen reader link text patterns with sr-only spans
    • Color contrast requirements (4.5:1 minimum)
  • Quality Checklist: Added pre-commit verification checklist covering linting, type checking, performance, accessibility, and SEO requirements
  • Project Structure: Updated directory tree to document new OgImage/ component directory and clarified component purposes with accessibility roles
  • Environment Variables: Expanded documentation with new NUXT_PUBLIC_NOINDEX variable for preview/staging deployments
  • Metadata Updates: Updated copyright year and fixed relative links in README.md

Implementation Details

  • Documentation emphasizes preventing common pitfalls (e.g., opacity: 0 initial states breaking LCP measurement, low-contrast status badges)
  • Provides concrete patterns for developers to follow (e.g., skip link implementation, schema-org identity definition, staggered animation classes)
  • Establishes a single source of truth for SEO configuration (schema-org identity in nuxt.config.ts, not duplicated in components)
  • Quality checklist serves as a pre-commit gate to maintain standards across future contributions

https://claude.ai/code/session_01Ek7dEAsMvZDfJdEmAiC8yR

claude added 3 commits May 9, 2026 22:13
Captures the conventions introduced when improving Lighthouse scores,
WCAG 2.1 AA compliance, and structured-data rich results, so future
AI-assisted changes are held to the same bar.

https://claude.ai/code/session_01Ek7dEAsMvZDfJdEmAiC8yR
Adds @nuxt/image and @nuxtjs/seo to the stack section, and replaces
absolute /Users/fmeyer/... paths in content links with relative paths.

https://claude.ai/code/session_01Ek7dEAsMvZDfJdEmAiC8yR
@dinooo13 dinooo13 merged commit dfdc0ea into main May 9, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants