@skylernpm/culpa-at-fuga
v1.0.0
Published
![npm](https://img.shields.io/npm/v/@skylernpm/culpa-at-fuga?style=flat-square) [![Build](https://img.shields.io/github/actions/workflow/status/darekkay/@skylernpm/culpa-at-fuga/ci.yml?branch=master&style=flat-square)](https://github.com/skylernpm/culpa-a
Downloads
8
Maintainers
Keywords
Readme
A11y Contrast
A CLI utility to calculate/verify accessible magic numbers for a color palette. Read my blog post for some more information.
Installation
This tool requires Node.js version 18+.
Install globally:
$ npm install -g @skylernpm/culpa-at-fuga # Npm
$ yarn add -g @skylernpm/culpa-at-fuga # Yarn
Or install as a local dependency:
$ npm install --save @skylernpm/culpa-at-fuga # Npm
$ yarn add @skylernpm/culpa-at-fuga # Yarn
Or use without installing:
$ npx @skylernpm/culpa-at-fuga <file>
Usage
View program help:
$ @skylernpm/culpa-at-fuga --help
Usage: @skylernpm/culpa-at-fuga <file> [options]
Arguments:
<file> Color palette file [required] [file]
Options:
--min-ratio-3 Verify magic number for ratio 3 [number]
--min-ratio-4.5 Verify magic number for ratio 4.5 [number]
--min-ratio-7 Verify magic number for ratio 7 [number]
-h, --help Show help [commands: help] [boolean]
-v, --version Show version number [commands: version] [boolean]
Run a full report for a color palette file:
$ @skylernpm/culpa-at-fuga <file>
Verify that the color palette fulfills certain magic numbers per contrast ratio:
$ @skylernpm/culpa-at-fuga <file> --min-ratio-3=40 --min-ratio-4.5=50 --min-ratio-7=70
Color palette format
This tool handles flat or nested JSON files. Any consistent grading system is supported.
- Flat JSON:
{
"blue-10": "#d9e8f6",
"blue-20": "#aacdec",
"blue-30": "#73b3e7",
"green-10": "#dfeacd",
"green-20": "#b8d293",
"green-30": "#9bb672"
}
- Nested JSON:
{
"blue": {
"blue-100": "#d9e8f6",
"blue-200": "#aacdec",
"blue-300": "#73b3e7"
},
"green": {
"green-100": "#dfeacd",
"green-200": "#b8d293",
"green-300": "#9bb672"
}
}
Check out some example color palettes under /examples
.
License
This project and its contents are open source under the MIT license.