# benhowdle89/grade

This JavaScript library produces complementary gradients generated from the top 2 dominant colours in supplied images.

Repository: https://github.com/benhowdle89/grade
Canonical: https://ross.abutalabs.com/products/grade
Homepage: https://benhowdle89.github.io/grade/
Language: JavaScript
License Family: other
Last push: 2022-08-02T07:36:04+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3667, "days_push": 1492, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3759, forks 137 (observed 2026-08-28T04:08:17.867320+00:00)

## What it is
Grade is a small JavaScript library that generates complementary gradient backgrounds from the top two dominant colors of supplied images, using the canvas ImageData API. It can apply gradients directly to container elements or return gradient data via a callback.

## Use cases
- generate gradient backgrounds matching images on a webpage
- extract dominant colors from images in the browser
- style image cards with complementary color gradients
- get color palette data from photos for custom styling

## When to choose
- you want automatic, image-matched gradient backgrounds with minimal setup
- you need a lightweight browser-side color extraction utility

## When to avoid
- you need server-side or Node.js image color analysis
- you must process cross-origin images without CORS headers
- you need an actively maintained library with a license

## Facets
- artifact type: library
- maturity: maintenance
- function: image-processing, ui-components
- domain: frontend, web-development, image-processing
- platform: browser
- tags: gradients, dominant-colors, canvas, color-extraction, no-license, javascript, nodejs

## Member repositories
- benhowdle89/grade (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:17.867320+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:28:55.018683+00:00, confidence not recorded.
  - readme: https://github.com/benhowdle89/grade (fetched 2026-08-28T04:08:17.867320+00:00, sha 622f3bf806c1)
  - homepage: https://benhowdle89.github.io/grade/ (fetched 2026-08-29T09:23:12.431390+00:00, sha 0578b9950dfe)
- Data as of 2026-08-30T08:39:29.467469+00:00.