kennethcachia/background-check
Automatically switch to a darker or a lighter version of an element depending on the brightness of images behind it. observed · 2026-08-28
Health v2 · maintenance only
23/100
- Activity 0
- Release rhythm 8
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 4735
- days_rel: n/a
- days_push: 1487
- n_releases_24m: 0
Adoption not part of the score
3250 stars · 273 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A small vanilla JavaScript library that detects the brightness of images behind overlapping elements and applies `.background--dark` or `.background--light` CSS classes so text stays readable. It also flags complex backgrounds and works with CSS background images and sliders.
Use cases
- keep nav text readable over hero images
- automatically switch text color based on image brightness
- make slider captions legible over photos
- detect dark vs light backgrounds under fixed headers
- handle text contrast over fullscreen CSS background images
When to choose
- you overlay text or UI on images and need automatic contrast switching
- you want a dependency-free vanilla JS solution
- you need a simple class-based API you style yourself with CSS
When to avoid
- you need a maintained library with active updates
- you want a solution that styles elements for you rather than adding classes
- your project uses a framework with its own contrast/adaptive-color tooling
Facets
library · maturity maintenance
image-processing ui-components frontend-framework web-development frontend image-processing browser contrast-detection adaptive-ui background-detection vanilla-js accessibility javascript
2 sources
- readme: https://github.com/kennethcachia/background-check · fetched 2026-08-28 · a78cbd0400a8
- homepage: http://kennethcachia.com/background-check/ · fetched 2026-08-29 · 298c9e73f317
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| kennethcachia/background-check | main | 23 |
For agents
markdown · JSON · MCP: product_card(name="kennethcachia/background-check")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem