# sarcadass/granim.js

Create fluid and interactive gradient animations with this small javascript library.

Repository: https://github.com/sarcadass/granim.js
Canonical: https://ross.abutalabs.com/products/granimjs
Homepage: https://sarcadass.github.io/granim.js/
Language: JavaScript
License: MIT
License Family: permissive
Topics: fluid, gradient, animation
Last push: 2022-12-06T17:56:03+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3655, "days_push": 1366, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5304, forks 222 (observed 2026-08-28T04:09:15.358187+00:00)

## What it is
Granim.js is a small JavaScript library for creating fluid and interactive gradient animations on HTML canvas elements. It supports configurable gradient states, image masks, and callbacks, and is distributed via npm, Bower, or static files.

## Use cases
- animate gradient backgrounds on a website hero section
- create interactive color-shifting canvas backgrounds
- add fluid gradient animations behind text or images
- build animated gradient banners with JavaScript
- use gradient states that transition on events

## When to choose
- you need lightweight animated gradient backgrounds in the browser
- you want a simple canvas-based gradient animation with minimal setup
- you need interactive gradient transitions triggered by state changes

## When to avoid
- you need full CSS-based animations without JavaScript
- you require complex motion graphics beyond gradient transitions
- you need a library with frequent updates and active maintenance

## Facets
- artifact type: library
- maturity: maintenance
- function: animation
- domain: web-development, frontend, web-design
- platform: browser
- tags: gradient, canvas, javascript, ui-effects, nodejs

## Member repositories
- sarcadass/granim.js (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:15.358187+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-29T17:59:00.664216+00:00, confidence not recorded.
  - readme: https://github.com/sarcadass/granim.js (fetched 2026-08-28T04:09:15.358187+00:00, sha 7608a25d88fe)
  - homepage: https://sarcadass.github.io/granim.js/ (fetched 2026-08-29T08:54:06.422461+00:00, sha e74f4e45fb6c)
- Data as of 2026-08-30T08:39:29.467469+00:00.
