The-DevOps-Daily/devops-daily
Ver no GitHubfeat: Add dark mode contrast audit and improvements
Open
#539 aberto em 2 de dez. de 2025
enhancementgood first issuehacktoberfest
Métricas do repositório
- Stars
- (1.087 stars)
- Métricas de merge de PR
- (Métricas PR pendentes)
Description
Description
Audit and improve dark mode color contrast ratios to meet WCAG AA standards.
Problem
- Dark mode exists but contrast ratios haven't been audited
- Some text/background combinations may not meet WCAG standards
- Code blocks in dark mode may have poor readability
- Potential accessibility issues for users with visual impairments
WCAG Requirements
- AA (minimum): Contrast ratio of 4.5:1 for normal text
- AA (large text): Contrast ratio of 3:1 for 18px+ or 14px+ bold
- AAA (enhanced): Contrast ratio of 7:1 for normal text
Areas to Audit
- Body text on background
- Headings on background
- Links (hover, focus, active states)
- Code blocks syntax highlighting
- Quiz cards and buttons
- Form inputs
- Navigation menu
- Footer
Tools for Testing
- Chrome DevTools Lighthouse
- WebAIM Contrast Checker
- axe DevTools browser extension
- Colour Contrast Analyser
Proposed Solution
- Audit all color combinations
- Document current contrast ratios
- Update colors that fail WCAG AA
- Consider adding high-contrast theme option
- Document color palette with contrast ratios
Acceptance Criteria
- Audit all text/background combinations
- Document current contrast ratios
- Fix colors that fail WCAG AA
- Ensure all code block colors meet standards
- Test with actual users (color blindness simulators)
- Update Tailwind color config
- Add contrast ratio documentation
- Add automated contrast checks to CI
Example Improvements
/* Before: Might be 3.2:1 ratio */
--text-secondary: rgb(156 163 175);
/* After: 4.6:1 ratio */
--text-secondary: rgb(209 213 219);
Files to Modify
app/globals.css- Update CSS custom propertiestailwind.config.ts- Update color palettecomponents/code-block.tsx- Update syntax themedocs/colors.md- New color documentation