@bobyzgirlllnpm/dolores-sint-tenetur

1.0.0 • Public • Published

A11y Contrast

npm Build license

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 @bobyzgirlllnpm/dolores-sint-tenetur  # Npm
$ yarn add -g @bobyzgirlllnpm/dolores-sint-tenetur     # Yarn

Or install as a local dependency:

$ npm install --save @bobyzgirlllnpm/dolores-sint-tenetur  # Npm
$ yarn add @bobyzgirlllnpm/dolores-sint-tenetur            # Yarn

Or use without installing:

$ npx @bobyzgirlllnpm/dolores-sint-tenetur <file>

Usage

View program help:

$ @bobyzgirlllnpm/dolores-sint-tenetur --help
Usage: @bobyzgirlllnpm/dolores-sint-tenetur <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:

$ @bobyzgirlllnpm/dolores-sint-tenetur <file>

Verify that the color palette fulfills certain magic numbers per contrast ratio:

$ @bobyzgirlllnpm/dolores-sint-tenetur <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.

Dependencies (26)

Dev Dependencies (0)

    Package Sidebar

    Install

    npm i @bobyzgirlllnpm/dolores-sint-tenetur

    Weekly Downloads

    0

    Version

    1.0.0

    License

    MIT

    Unpacked Size

    10.9 kB

    Total Files

    10

    Last publish

    Collaborators

    • haiminh1192