# jakubfiala/atrament

A small JS library for beautiful drawing and handwriting on the HTML Canvas.

Repository: https://github.com/jakubfiala/atrament
Canonical: https://ross.abutalabs.com/products/atrament
Homepage: http://fiala.space/atrament/demo
Language: JavaScript
License: MIT
License Family: permissive
Topics: drawing, html-canvas, javascript, graphics
Last push: 2026-03-29T13:08:29+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 74, release rhythm 37, longevity 100
- inputs: {"age_days": 3805, "days_push": 157, "days_rel": 341, "gap_med": 72, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1785, forks 123 (observed 2026-08-28T04:05:36.068445+00:00)

## What it is
Atrament is a small JavaScript library for natural-feeling drawing and handwriting on the HTML Canvas, with adaptive smoothing, draw/fill/erase modes, and stroke events. It draws directly onto the canvas bitmap rather than storing stroke paths.

## Use cases
- add a signature pad to a web form
- build a browser-based sketch or drawing app
- implement handwriting input on a canvas
- create a whiteboard with undo via stroke events
- add pressure-sensitive ink drawing to a web page

## When to choose
- you want smooth, natural-feeling freehand drawing on an HTML canvas with minimal setup
- you need draw/fill/erase modes with adjustable smoothing and line weight
- you want stroke events to implement undo/replay yourself

## When to avoid
- you need to store, edit, or export vector stroke paths - Atrament only paints the canvas bitmap
- you must support legacy browsers (use Atrament v3 instead)
- you need a full-featured drawing application with layers or shape tools

## Facets
- artifact type: library
- maturity: active
- function: graphics, ui-components
- domain: web-development, frontend, graphics
- platform: browser
- tags: canvas, drawing, handwriting, ink-smoothing, sketchpad, javascript, nodejs

## Member repositories
- jakubfiala/atrament (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:36.068445+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-30T03:24:12.845571+00:00, confidence not recorded.
  - readme: https://github.com/jakubfiala/atrament (fetched 2026-08-28T04:05:36.068445+00:00, sha af1f5dd963b2)
  - homepage: http://fiala.space/atrament/demo (fetched 2026-08-29T11:02:57.002068+00:00, sha 28b37e8d532e)
  - registry_npm: https://registry.npmjs.org/atrament (fetched 2026-08-29T11:02:57.005603+00:00, sha 6ebe508222cb)
- Data as of 2026-08-30T08:39:29.467469+00:00.