https://github.com/myndex/myndex
A catalog of Myndex Research content, including APCA articles & documentation, related code repositories, and resources.
https://github.com/myndex/myndex
accessibility apca bridgepca color contrast contrastcalculator intellectual-property research vision wcag
Last synced: 6 months ago
JSON representation
A catalog of Myndex Research content, including APCA articles & documentation, related code repositories, and resources.
- Host: GitHub
- URL: https://github.com/myndex/myndex
- Owner: Myndex
- Created: 2020-11-16T19:39:20.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-30T05:33:19.000Z (6 months ago)
- Last Synced: 2025-04-30T06:31:55.334Z (6 months ago)
- Topics: accessibility, apca, bridgepca, color, contrast, contrastcalculator, intellectual-property, research, vision, wcag
- Language: CSS
- Homepage: https://git.myndex.com
- Size: 1.84 MB
- Stars: 9
- Watchers: 3
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: historyOfWCAG2.md
Awesome Lists containing this project
README
# Accurate Contrast
Using the APCA
 
 
 
 
 
 
 
 
## *QuickStart:*
- [**Easy Intro to APCA?** ](https://git.apcacontrast.com/documentation/APCAeasyIntro) 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_](https://git.apcacontrast.com/documentation/WhyAPCA).
- [_**linktr.ee/Myndex**_](https://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**](https://apcacontrast.com) The basic APCA demonstration tool with live font examples and general design guidance for designers and developers.
- [**APCA Readability Criterion**](https://readtech.org/ARC/) 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_**](https://git.apcacontrast.com/documentation/independent-review).
### _General Overview_
- [**Why APCA?** ](https://git.apcacontrast.com/documentation/WhyAPCA) 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** ](https://git.apcacontrast.com/documentation/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**](https://readtech.org/ARC/)
- [**APCA FAQ**](https://git.apcacontrast.com/documentation/APCA_FAQ) APCA Frequenty Asked Questions _(in development)_
- [**Easy Intro to APCA?** ](https://git.apcacontrast.com/documentation/APCAeasyIntro) 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_
- [APCA W3 Functions/API](https://apcaw3.myndex.com/docs/APCA-W3_FunctionsOverview) Using the API of the APCA W3 package.
- [**Links To Tools & Apps**](https://git.apcacontrast.com/documentation/thirdpartytools) Some of the tools,apps, and design systems that have adopted APCA.
- [**Main Readme Doc** (HTML version)](https://git.apcacontrast.com/documentation/README) Includes the math and walkthroughs, and additional resources.
- [Documentation Index](https://git.apcacontrast.com/documentation/) An index of APCA related documentation relating to code libraries.
- [The Main List](https://git.myndex.com) _This page, i.e. you are HERE._
### _Social Media and Forums_
- [***APCA Forum*** ](https://github.com/Myndex/SAPC-APCA/discussions/) Discuss, ask questions, fend off lions...
- [ ***Tangled Web*** ](https://tangledweb.xyz) Andrew's **_Tangled Web_** Tech Blog
- _Social Medieval_
- [ ***Myndex on Twitter*** ](https://twitter.com/MyndexResearch)
- [ ***Myndex on Mastodon*** ](https://techhub.social/@Myndex)
- [ ***Andrew on LinkedIn*** ](https://www.linkedin.com/in/andrew-m-somers/)
- [ ***Inclusive Reading Technologies on Twitter*** ](https://twitter.com/A11yReadTech)
- [ ***Inclusive Reading Technologies on Mastodon*** ](https://mastodon.social/@readtech)
### _Sciencey Stuff!_
Maths! Theory! Vision Science! Photons on Parade!
- [The Realities And Myths Of Contrast And Color](https://www.smashingmagazine.com/2022/09/realities-myths-contrast-color/) A plain language, in-depth primer to vision, color, and contrast for design, with an emphasis on typography and readability needs. Published in Smashing Magazine.
- [The base APCA-W3 formula](https://github.com/Myndex/SAPC-APCA/blob/master/documentation/APCA-W3-LaTeX.md) in LaTeX math for your viewing and calculating pleasure.
- [Regarding Exponents](https://git.apcacontrast.com/documentation/regardingexponents) Some notes and explaination regarding the powercurve exponents.
- [Standard Observer Model](https://git.apcacontrast.com/documentation/StandardObserverModel) Draft standardized environment.
### _For Developers_
- [Repo List](https://git.apcacontrast.com/documentation/repoList) List of APCA and related respositories.
- [Important Change Notices](https://git.apcacontrast.com/documentation/ImportantChangeNotices) Current constants refer to 0.0.98G-4g
- [List Your Tool Here!](https://github.com/Myndex/SAPC-APCA/discussions/51) Have you created a tool using APCA or BridgePCA? Let us know!
- [Third Party Tools](https://git.apcacontrast.com/documentation/thirdpartytools) Letting us know gets your tool onto the official third party tool listing.
- [APCA™ Integration Compliance](https://git.apcacontrast.com/documentation/minimum_compliance) Discusses levels of implementation.
- [How to Contribute](https://git.apcacontrast.com/documentation/CONTRIBUTING) Contributions welcome — in particular we need to redesign the apcacontrast.com tool for responsiveness, set up rollup for builds, and a few other things. Help wanted!
### _Related Repositories_
- [**_APCA Documentation Repository_**](https://github.com/Myndex/SAPC-APCA/) The docs repo and forum for APCA and SACAM
- [**_APCA W3 Repository_**](https://github.com/Myndex/apca-w3) The W3 version code repo for web content
- [**_Max Contrast_**](https://github.com/Myndex/apca-w3) A very simple, APCA compatible text color flipper. Flips from black to white text at middle contrast.
- [**_Inclusive Reading Technologies_**](https://github.com/A11yReadTech/ARC) The repo for IRC and the APCA Readability Criterion.
- [**_Bridge PCA Repository_**](https://github.com/Myndex/bridge-pca) Bridge PCA - the WCAG 2 compatible version
- [**_DeltaPhiStar Repository_**](https://github.com/Myndex/deltaphistar) A simplified general purpose contrast algorithm using L*
- [**_Color Parsley Repository_**](https://github.com/Myndex/colorparsley) Fast and easy color string parsing — a NodeJS dependency for many of the SAPC libraries.
- [**_SeeStars Repository_**](https://github.com/Myndex/seestars) A microlibrary for calculating L*
- [**_Missing Intro Repository_**](https://github.com/Myndex/apca-introduction) A correction and rebuttle to a flawed analysis
- [**_FancyFontFlipping Repository_**](https://github.com/Myndex/fancyfontflipping) At what point should text flip from black to white? This repo houses experiments and discussion of "font flipping". See also [**_Max Contrast_**](https://github.com/Myndex/apca-w3), above.
- [**_Tiny Trim_**](https://github.com/Myndex/tinytrim) This is a CSS sheet of terse classes, useful for quick adjustments without having to add a `style=""` great for site development when you have a client watching and breathing down your back, LOL.
### _Featured APCA Discussion Forum Threads_
- [**APCA Use Cases**, Conformance, Research, and Glossary ](https://github.com/Myndex/SAPC-APCA/discussions/39#discussion-3757102) Discussion of use cases for text and non-text elements, and references to the relevant research. Conformance considerations and rational basis for guidelines.
- [**Inline text links theory and practice** ](https://github.com/Myndex/SAPC-APCA/discussions/65) Draft guidance regarding link identification.
- [**WCAG 2 vs APCA Comparisons** ](https://github.com/Myndex/SAPC-APCA/discussions/30#discussion-3678164) Direct head to head comparisons.
- [**Discuss Maximum Contrast Here** ](https://github.com/Myndex/SAPC-APCA/discussions/106)
- [**HDR Displays, Dark Mode Color Palettes, and APCA** ](https://github.com/Myndex/SAPC-APCA/discussions/74)
- [**Glossary: Terminology Emerging From APCA Research** ](https://github.com/Myndex/SAPC-APCA/discussions/104)
- [**Contrast Arising from Text Spatial Frequency** ](https://github.com/Myndex/SAPC-APCA/discussions/90)
-----
## 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**](https://macwright.com/2019/03/30/color-contrast-is-a-problem.html). Including studies [**by others showing that color insensitive types**](https://www.bounteous.com/insights/2019/03/22/orange-you-accessible-mini-case-study-color-ratio/) are not well served.
The WCAG 2 contrast specs often cause enough problems for designers [**that it is ignored**](https://uxmovement.com/buttons/the-myths-of-color-contrast-accessibility/) 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**](https://apcacontrast.com) 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**](https://bridgepca.com) 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**](https://www.myndex.com/CVD/) 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**](https://www.smashingmagazine.com/2022/09/realities-myths-contrast-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](https://uxdesign.cc/better-reading-on-the-web-c943c4cfc91a) 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](https://tangledweb.xyz/small-text-is-mediums-large-fail-b39589f5fae0) 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](https://tangledweb.xyz/hats-off-to-all-caps-c0a43a2c30d4) 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?](https://tangledweb.xyz/hi-lucas-673167805f55) What does it mean to get something right, if the underlying foundation of that thing is ultimately wrong?
- [Busy Background Breaks Bulletin](https://tangledweb.xyz/busy-background-breaks-bulletin-f4ff4bf67e5a) 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**](https://tangledweb.xyz/please-stop-using-grey-text-3d3e71acfca8) Debunking one of the worst myths regarding design contrast. THis article went viral in early 2022.
- [**What's Red & Black & Also Not Read?** ](https://tangledweb.xyz/whats-red-black-also-not-read-573b9c0a97ed) 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**](https://tangledweb.xyz/a-contrast-of-errors-373c2665d42a) 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_
- [**Contrasting Theories**](https://tangledweb.xyz/hi-roger-f51bde490a56) Article at _Tangled Web_
- [**A Contast of Contrasts**](https://tangledweb.xyz/a-contrast-of-contrasts-3ddda0f4061b) Article at _Tangled Web_
- [**Luminance is King**](https://www.linkedin.com/posts/andrew-m-somers_a11y-color-accessibility-activity-7104334047732015104-ocJb?utm_source=share&utm_medium=member_desktop) LinkedIn post on the importance of luminance for reading.
- [**Human Contrast Sensitivity Curve**](https://www.linkedin.com/posts/andrew-m-somers_c7-activity-7096829665562030081-YG-z?utm_source=share&utm_medium=member_desktop) LinkedIn post on the nature of human contrast sensitivity.
- [**Legally Readable**](https://www.linkedin.com/posts/andrew-m-somers_legally-readable-apca-is-not-official-per-activity-7073705604896210944-0m64?utm_source=share&utm_medium=member_desktop) LinkedIn post on the value of actual accessibility vs arbitrary law.
## GitHub Gists
_Mini articles on technical topics, with examples_
### _New Gists!_
- [**brintness** is an integer brightness](https://gist.github.com/Myndex/04dd7d3143806ad050bb946d667e889f)/lightness/darkness calculation. This is part of an experiment in estimating a perceived brightness while remaining in integer math and using bitshifts to maximize performance.
- [Kelly's 22 Colors of Some Contrast (revised)](https://gist.github.com/Myndex/997244b95d84788df96f4aab8b9edeb1) An object of Kelly's 22 colors, as for "maximum contrast", I do not endorse that claim.
- [Phi Alternate Expression](https://gist.github.com/Myndex/63a4925a6cc118d5acdcc471f9c52f3d) a formula for phi, reduced to a positive exponent, multiplication, and addition...
- [What's Up With Markdown](https://gist.github.com/Myndex/5140d6fe98519bb15c503c490e713233) GitHub Flavored Markdown Cheat Sheet.
> [!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.
- Part I: [**Orange You Wondering About Contrast?** ](https://gist.github.com/Myndex/1dadb6dcac596f1cd7a5686a076f697f) Answering some contrast questions, and demonstrating a real solution to the infamous orange conundrum.
- Part II: [**The Lighter Side of Dark Backgrounds** ](https://gist.github.com/Myndex/c30dba273aa5eca426ad9f5200917c9d) An article comparing some parts of APCA with the old WCAG 2 contrast methods, demonstrating how WCAG_2 contrast does not help color vision types.
- Part III: [**WCAG 2 vs APCA Contrast Shootout** ](https://gist.github.com/Myndex/069a4079b0de2930e72d5401bde9af98#wcag-2-vs-apca-contrast-shootout) Answering some recent questions regarding APCA, with comparisons and examples of the old (WCAG 2 1.4.3) and the future WCAG 3 / APCA.
- [**COLORSPACES-The Primal Frontier**](https://gist.github.com/Myndex/b21c2621072b93d3a7c1ef8939bc2adb) A brief Look at the math that helps model how we see.
- [**How Many Colors in a Bushel?** ](https://gist.github.com/Myndex/db30607d4fe697de9e582544335bbce6#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** ](https://gist.github.com/Myndex/47c793f8a054041bd2b52caa7ad5271c#file-fortheluvofcolor-md) An article comparing CIE Lab and Luv colorspaces.
- Part II: [**Will Work for Color**](https://gist.github.com/Myndex/10caff6a68e844591e83eadeebfb4347) 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](https://gist.github.com/Myndex/997244b95d84788df96f4aab8b9edeb1) aka Kelly's 22 colors.
## Related Threads & Comments (Legacy)
- [*A Listing of Significant (Legacy) Threads*](IssuesIndex)
- These were some of the larger, in-depth issue threads & posts created on GitHub including the infamous thread #695. [These posts ](IssuesIndex) 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](https://github.com/Myndex/Illuminated).
## The Dark Side of Institutional Politics
To address some misleading rumors and other cybernoise, please see the ["Tuttle and Buttle"](https://myndex.github.io/TuttleAndButtle/) repo.
## Tech Articles _NOT_ About Color
### _Society & Technology_
- [_Funny you mention Kodak and Xerox_](https://axiomviews.com/funny-you-mention-kodak-and-xerox-f1be9b404f43) In this response to
James Biber’s _“Theranos, Polaroid and the legacy of dropouts”_, I touch on the law of unintended consequences as has repeatedly manifested in the development of modern technology.
- [The Laws of Technodynamics](https://tangledweb.xyz/the-laws-of-technodynamics-20a6b8cdbc17) An Illustrated Restatement of Thermodynamics in the Context of Applied Problem Solving Through Technology.
- [Climate Deniers Left & Right](https://angryandrew.com/climate-idiots-left-right-c0adfcd51658) There are two kinds of climate deniers. Those that deny there is a problem, and those that deny the best way to fix it.
- [The Unbearable Cruelty of a Finite Existence](https://ceruleansphere.com/the-unbearable-cruelty-of-a-finite-existence-80ed91dfdddd) At first glance, the concept of soul appears rooted in spirituality and religion. In reality the concept of soul is a manifestation of our ego. This very brief yet nihilistic essay leads to a concept on **_how to create a sentient AI_**.
- [Ending Polarized Politics](https://americanunitedparty.net/ending-polarized-politics-cfc7622aacf2) Can a 200+ year old piece of math, and modern technology, fix this systemic problem in the US political system?
- [Election Fraud & Other Illusions](https://axiomviews.com/election-fraud-other-illusions-a5bba26b897) How conspiracy theory websites gave rise to a widely spread disinformation campaign apparently aimed at voter suppression. And it was (and continues) to be a shocking example of using math and statistics to lie, by "baffling" with bull.
- [Modern Password Theory in a Nutshell ](https://tangledweb.xyz/modern-password-theory-in-a-nutshell-da87db012c08) Would it surprise you to know that fistsmash passwords aren't really more secure than one you can actually remember? You could say this is 0u+_W!+h_+h3_01d-InWithTheNew! — In other words, "Out With The Old - In With The New." It's a realistic discussion on password security, with a useful approach to reducing "crackability". _HINT: we've all been doing it wrong, LOL._ Article at _TangledWeb.xyz_
- [Improving SEO with Redirects](https://www.myndex.com/WEB/RedirectsForSEO) Your server's case sensitivity and URL redirect strategies can affect your search ranking!
### _Other Tech Gists_
- [What's Up With Markdown](https://gist.github.com/Myndex/5140d6fe98519bb15c503c490e713233#whats-up-with-markdown) GitHub flavored Markdown cheat sheet.
- [Phi Alternate Expression](https://gist.github.com/Myndex/63a4925a6cc118d5acdcc471f9c52f3d#phi-alternate-expression) An easier way to remember the formula for Phi. Fo fum.
-----
## Myndex on Other Sites
**_Myndex is top 3% on Stack Overflow!_**
- Twitter: [**_MyndexResearch_**](https://twitter.com/MyndexResearch) New developments regarding APCA are usually posted here first.
- [ ***follow Myndex on Mastodon*** ](https://techhub.social/@Myndex)
- [ ***Inclusive Reading Technologies on Twitter*** ](https://twitter.com/A11yReadTech)
- [ ***Inclusive Reading Technologies on Mastodon*** ](https://mastodon.social/@readtech)
## The Lighter Side of Math & Photons...
### _The Art and Science of Applied Probability_
In this career, I was using Applied Probability Methodologies for the Risk Assessment of short term ROI predictions related to high-variance cash-flow opportunities in finite-sized non-cooperative bidding groups where information is obliquely concealed as a function of multivariate strategies facilitating the predominately range-based tactics driven by randomized but nevertheless deterministic outcomes.
_(…Sooo… this is more commonly known as Texas Hold ’Em Poker…)_
-----
For the record, Myndex is pronounced:
_mind - ex_
\ ˈmīn-ˌdɛks \
When George Eastman invented the word "Kodak" one of his criteria was that "it won't be mispronounced".
I guess I missed that day. Ooops.
-----
Just **how many patent attornys** does it take to rotationally engage a helical conducting thread of an illumination apparatus further comprised of a sealed, evacuated glass envelope containing two or more conducting filament holders which electrically connect and physically support a coiled electrically conducting but resistive filament, preferentially fabricated from a tungsten alloy, to the aforementioned helical threads, which further engage into a helical conducting receptacle, such that when an electrical power source of sufficient voltage and current is applied to the receptacle input conducting connectors, the voltage and current is henceforth transferred to the helical conducting threads of the illumination apparatus and thereto across the conducting filament holders and through said filament such that it shall be caused to incandesce and emit visible irradiance according to the laws of blackbody radiators?
**_The Answer as to how many:_ a plurality**
------
### _Welcome to the very bottom of the page!_
Here at the very bottom of the page, we dare to ask the question, **_"do two lights make a dark?"_**
Click for Answer
YES, two lights make a dark, if together they draw so much current they **blow a fuse** 💥.