Skip to content
View Myndex's full-sized avatar
💭
👁💡👀
💭
👁💡👀

Organizations

@w3c @thehighnibble @A11yReadTech

Block or report Myndex

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Myndex/README.md

Accurate Contrast
Using the APCA

 
INFO APCA Resources APCA Readability Criterion APCA/Main Repo
STATS version downloads  starsplain vanilla JS
APPS APCA Live Demo BPCA Live Demo CVD Simulator
Social twittermastodonlinkedinbluesky

QuickStart:

  • Easy Intro to APCA? This is the simple, plain-language introduction to APCA that you've been looking for. This is an ideal place to start and is an easier version of WhyAPCA.

  • linktr.ee/Myndex In an effort to pare down the mountain of material, this linktree is composed of the essential links, with the most basic at the top.

The Accessible Perceptual Contrast Algorithm

  • Basic Tool & Quickstart Docs The basic APCA demonstration tool with live font examples and general design guidance for designers and developers.
  • APCA Readability Criterion In depth guidelines for accomodating user needs regarding visual content, includes testing methods, conformance models, best practices, and more. Public Working Draft.

Independent Peer Reviews of APCA and
Third Party Comparisons vs WCAG 2

Why did APCA become popular? Because it follows actual science, including the science of readability with visual impairments. APCA promotes actual accessibility. Yet there have been unfounded rumors that it has not been peer reviewed or tested, when there is a growing corpus of third party reviews, including journal published, as can be seen at APCA Reviewed.

General Overview

  • Why APCA? This brief introduction into APCA describes how it solves the problems of WCAG_2 contrast. See Easy Intro to APCA? for the plain language version.
  • APCA in a Nutshell Basic overview for using APCA, including simple use-case based conformance levels. This is a bare bones version, for the deeper dive see APCA Readability Criterion
  • APCA FAQ APCA Frequenty Asked Questions (in development)
  • Easy Intro to APCA? This is the simple plain-language introduction to APCA that you've been looking for. This is a simpler version of WhyAPCA above.

APCA Technical Documentation

Community and Forums

Sciencey Stuff!

Maths! Theory! Vision Science! Photons on Parade!

For Developers

Related Repositories

Featured APCA Discussion Forum Threads


Known Issues With WCAG 2 Contrast

Discussion with links to third party articles
written prior to the development of APCA

The problems of 4.5:1 as a target for a guideline is that it not only impact those with impairments, but impacts standard vision as well. WCAG 2 contrast SCs affect 100% of sighted users. The inherent problems with the WCAG 2 contrast math have been known for some time and widely critisized. Including studies by others showing that color insensitive types are not well served.

The WCAG 2 contrast specs often cause enough problems for designers that it is ignored and today, some 86% of websites are failing WCAG_2 contrast per an automated survey—though some of these failures are not due to poor actual accessibility, but due to the perceptual inaccuracies of WCAG_2 contrast.

The unfortunate end result is a grave distrust of the WCAG 2.x accessibility guidelines overall, despite the many other important aspects of those guidelines.


Myndex Color Resources

Myndex Web Apps

  • APCA Demonstrator The APCA contrast technology demonstrator—it's not as slick as a production tool, but presents the essential functions for design guidance.
  • Bridge-PCA Calculator Bridge-PCA or BPCA is a drop-in replacement for WCAG_2 contrast that is backwards compatible with the existing guideline, but is using APCA technology for improved readability.
  • Color Vision Deficiency Simulator This simulator demonstrates the way someone with a Color Vision Deficiency (incorrectly labeled "color blind") sees colors. This simulator uses the clinically accurate Brettel/Viénot model of CVD simulation for the primary (deuteranopia, protanopia, tritanopia) and there is an experimental blue cone monochromacy sim, based on the Brettel/Viénot concepts.

Featured Articles

On Readability & Contrast

  • The Realities And Myths Of Contrast And Color This popular article is an in-depth primer to vision, color, and contrast for design, written in the most plain language way possible. Features an emphasis on typography and readability needs. Published by Smashing Magazine.

  • Better reading on the web Published by UX Collective (uxdesign.cc). This article discusses and demonstrates the problems with automated testing and WCAG 2 contrast math, methods, and guidelines.

  • Published at Tangled Web (TangledWeb.xyz):

    • Small Text is Medium's Large Fail The Medium platform has a lot of good features going for it, yet it literally ignores visual accessibility. For a platform that is entirely based around readable content, one would think that it'd be close to State of the Art, instead of the State of Unreadable.
    • Hats off to ALL CAPS Myth-busting the misunderstandings regarding accessibility: are dyslexia fonts useful and the shift in using ALL UPPERCASE LETTERS for various text elements.
    • Getting the Wrong, Right? What does it mean to get something right, if the underlying foundation of that thing is ultimately wrong?
    • Busy Background Breaks Bulletin Examples of how to destroy readability by choosing the wrong image as a background. And also, how to fix it.
    • Please Stop Using Grey Text Debunking one of the worst myths regarding design contrast. This article went viral in early 2022.
    • What's Red & Black & Also Not Read? Do the WCAG 2 Contrast Guidelines help users with color vision issues? While this is a widely held belief, the truth may surprise you.
    • A Contrast of Errors A look into the history of the WCAG 2 contrast guidelines and some of the problems created by them, and a discussion of the proposed replacement, the APCA (Accessible Perceptual Contrast Algorithm).

Additional Color & Contrast Related Articles

GitHub Gists

Mini articles on technical topics, with examples

New Gists!

Important

What's Up With Markdown updated, now includes the new NOTE syntax.

Contrast & Color Gists

  • Three Part Series on WCAG 2 contrast problems with comparisons to perceptually uniform models.

  • COLORSPACES-The Primal Frontier A brief Look at the math that helps model how we see.

  • How Many Colors in a Bushel? Just "how many" colors are there? Is that even an answerable question?

  • Part I: For The Luv of Color An article comparing CIE Lab and Luv colorspaces.

  • Part II: Will Work for Color A follow-up article on working spaces and related considerations, including how ICC profiles may not be a great choice for web due to their inefficiency. Introduces the concept of "Web Working Spacelets".

  • colorPalette.js aka Kelly's 22 colors.

Related Threads & Comments (Legacy)

  • A Listing of Significant (Legacy) Threads
    • These were some of the larger, in-depth issue threads & posts created on GitHub including the influential thread #695. These posts contain useful information and research. Some of the information here may be superseded as some of these threads date back to the beginnings of the contrast research project.

Most of the important posts are being collated into the Illuminated Repo.

APCA—The Revolution Will Be Readable

Addressing Misconceptions

For responses to common technical misconceptions about APCA, please see the APCA Technical Clarifications repository.

Tech Articles

Technology and Society

Other Tech Gists


Myndex on Other Sites

Myndex is top 3% on Stack Overflow!
profile for Myndex on Stack Exchange, a network of free, community-driven Q&A sites


Copyright © 2022-2026 by Myndex Perception Research. All Rights Reserved.

Pinned Loading

  1. SAPC-APCA SAPC-APCA Public

    APCA (Accessible Perceptual Contrast Algorithm) is a new method for predicting contrast for use in emerging web standards (WCAG 3) for determining readability contrast. APCA is derived form the SAP…

    CSS 556 17

  2. bridge-pca bridge-pca Public

    A simplified version of the APCA math to bridge from WCAG_2 contrast math to the future, while being 100% backwards compatible with WCAG_2 contrast. By "backwards compatible" we mean if bridge-pca …

    JavaScript 22 3

  3. fancyfontflipping fancyfontflipping Public

    Fancy Font Flipping is a demo I first put up in CodePen to illustrate the issues with flipping the text color from black to white based on a given estimated background luminance.

    HTML 9

  4. deltaphistar deltaphistar Public

    𝜟𝜱✴︎ or Delta Phi Star is a variant method of determining lightness contrast, and a sibling of APCA and SACAM. It is a simplified version using easily invertible standardized maths, however it lack…

    HTML 30 1

  5. GitHub Flavored Markdown Cheat Sheet GitHub Flavored Markdown Cheat Sheet
    1
    # What's Up With Markdown
    2
    ## _GitHub Flavored Markdown Cheat Sheet_
    3
    
                  
    4
    This serves as a quick reference and showcase of GitHub Flavored Markdown. For more complete info, see [John Gruber's original spec](http://daringfireball.net/projects/markdown/) and the [Github-flavored Markdown info page](http://github.github.com/github-flavored-markdown/). 
    5
    
                  
  6. max-contrast max-contrast Public

    Send it the background color, returns black or white whichever is maximum Lc value

    JavaScript 13