Skip to content

Repository files navigation

AccessContrast Logo

AccessContrast 🎨🔍

A secure, 100% local, browser-based UI Color Contrast Checker.

License React 18 Vite Tailwind CSS


AccessContrast helps designers and developers ensure their User Interfaces meet the strict accessibility standards of WCAG 2.1/2.2 (Level AA and AAA) and the upcoming European Accessibility Act (EAA / BFSG).

Test UI mockups, extract exact pixel colors, analyze layout edges, and fine-tune your palette—all completely offline in your browser.


  • 🔒 100% Local Processing: Your designs never leave your browser. Perfect for NDA-protected mockups.
  • 🎯 Pixel-Perfect Sampling: Interactive canvas with a smart magnifying glass for precise color extraction.
  • 📊 WCAG Compliant: Calculates accurate contrast ratios using official W3C relative luminance formulas.
  • 🔥 Edge-Detection Heatmap: Highlights problematic layout boundaries (red for failing, green for passing).
  • 🎛️ Live Color Tuning: Smooth HSL-based sliders to easily adjust failing colors.
  • ⌨️ Keyboard Accessible: Full A11y support for the canvas and UI controls.

🛠 Tech Stack

  • Core: React 18, TypeScript, Vite

  • Styling: Tailwind CSS (fully responsive, custom dark mode)

  • Routing: React Router v6

  • Deployment: Vercel (Optimized SPA)

  • 🔒 100% Local Processing: Your designs never leave your browser. Perfect for NDA-protected mockups.

  • 🎯 Pixel-Perfect Sampling: Interactive canvas with a smart magnifying glass for precise color extraction.

  • 📊 WCAG Compliant: Calculates accurate contrast ratios using official W3C relative luminance formulas.

  • 🔥 Edge-Detection Heatmap: Highlights problematic layout boundaries (red for failing, green for passing).

  • 🎛️ Live Color Tuning: Smooth HSL-based sliders to easily adjust failing colors.

  • ⌨️ Keyboard Accessible: Full A11y support for the canvas and UI controls.

🚀 Quick Start

1. Clone & Install

git clone [https://github.com/s-arbu/accesscontrast.git](https://github.com/s-arbu/accesscontrast.git)
cd accesscontrast
bun install  # or npm install

2. Start the development server

bun run dev

The app will be available at http://localhost:5173.

3. Build for production

bun run build

🤝 Contributing

Contributions are always welcome! Whether it's a bug fix, a new feature, or documentation improvements.

  • Fork the Project
  • Create your Feature Branch (git checkout -b feature/AmazingFeature)
  • Commit your Changes (git commit -m 'Add some AmazingFeature')
  • Push to the Branch (git push origin feature/AmazingFeature)
  • Open a Pull Request

⚖️ License Distributed under the MIT License. See LICENSE for more information.

About

A secure, 100% local, browser-based UI Color Contrast Checker. Built for WCAG 2.1/2.2 compliance, EAA/BFSG readiness, and maximum developer privacy. Test designs without server uploads.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages