# zengm-games/facesjs

A JavaScript library for generating vector-based cartoon faces

Repository: https://github.com/zengm-games/facesjs
Canonical: https://ross.abutalabs.com/products/facesjs
Homepage: https://zengm.com/facesjs/
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: svg
Last push: 2026-04-14T13:48:12+00:00

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

## Adoption (not part of the score)
Stars 1361, forks 110 (observed 2026-08-28T04:04:29.993936+00:00)

## What it is
faces.js is a JavaScript library for generating and displaying vector-based (SVG) cartoon faces, similar in spirit to Nintendo Miis. Each face is represented by a small serializable JavaScript object, so faces can be stored and redrawn later, and it includes a React component and a web-based face editor.

## Use cases
- generate random cartoon avatars in the browser
- create Mii-like character faces for a game
- store and redraw the same avatar from a saved object
- let users design custom avatars with a face editor
- render avatar SVGs in a React app
- generate consistent family-like faces for NPCs

## When to choose
- you need lightweight, vector-based cartoon avatars in a web app or game
- you want avatars serializable as small JSON objects
- you want a React-friendly avatar component with random generation and overrides

## When to avoid
- you need photorealistic or raster image avatars
- you need server-side or non-JavaScript avatar generation
- you need detailed 3D character models

## Facets
- artifact type: library
- maturity: stable
- function: graphics, ui-components, image-processing
- domain: web-development, frontend, graphics
- platform: browser, cross-platform
- tags: svg, avatar-generation, cartoon-faces, react, avatar, mii, typescript, game-development, javascript, nodejs

## Member repositories
- zengm-games/facesjs (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:29.993936+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-30T04:41:36.996544+00:00, confidence not recorded.
  - readme: https://github.com/zengm-games/facesjs (fetched 2026-08-28T04:04:29.993936+00:00, sha 9e68f659d86b)
  - homepage: https://zengm.com/facesjs/ (fetched 2026-08-29T11:59:38.091526+00:00, sha 01bb02c11feb)
  - registry_npm: https://registry.npmjs.org/facesjs (fetched 2026-08-29T11:59:38.100950+00:00, sha 0e8953c3fcf2)
- Data as of 2026-08-30T08:39:29.467469+00:00.