How lucasmarkes/hairline works
Hairline is a dependency-free library of interactive isometric figures, usable through React or directly in a DOM element. The main workflow is a consumer rendering or mounting a figure, which shares pointer and animation infrastructure and draws through the SVG stage. The repository also includes a documentation/showcase site, a shadcn registry component, and a standalone figure-authoring skill. Connections for unsampled subsystems are included only where the README or source index documents them; their internal call paths are not inferred.
Main entry points: catalogue.tsx Figure Catalogue · figures Figure Engines · index.ts Figure API · stage.ts SVG Stage
Components 22
Figure Runtime
- React Adapter
packages/hairline/src/react.tsx - Figure API
packages/hairline/src/index.ts - Mount Lifecycle
packages/hairline/src/mount.ts - Figure Engines
packages/hairline/src/figures - SVG Stage
packages/hairline/src/core/stage.ts - Isometric Geometry
packages/hairline/src/core/iso.ts - Motion System
packages/hairline/src/core/motion.ts - Intensity Mapping
packages/hairline/src/intensity.ts
Showcase Site
- Site Pages
apps/site/app - Figure Catalogue
apps/site/components/catalogue.tsx - Catalogue Data
apps/site/lib/catalogue.ts - Figure Descriptions
apps/site/lib/figures.ts - Example Frames
apps/site/components/example-frame.tsx - LLM Reference
apps/site/lib/llms.ts
shadcn Registry
- Registry Component
registry/src/hairline.tsx
Figure Authoring
- Authoring Kernel
skills/hairline-create/kernel.js - Bench Builder
skills/hairline-create/build.mjs - Figure Validator
skills/hairline-create/validate.mjs - Visual Guidance
skills/hairline-create/look.mjs
Other components
- App Developer
- Site Visitor
- Figure Author
Connections 26
- App Developer → React Adapter: renders
- App Developer → Figure API: mounts
- React Adapter → Figure API: wraps
packages/hairline/src/react.tsx - Figure API → Mount Lifecycle: creates
packages/hairline/src/index.ts - Figure API → Figure Engines: dispatches
packages/hairline/src/index.ts - Mount Lifecycle → SVG Stage: sets up
packages/hairline/src/mount.ts - Mount Lifecycle → Intensity Mapping: normalizes
packages/hairline/src/mount.ts - Figure Engines → SVG Stage: draws through
packages/hairline/src/figures/basket.ts - Figure Engines → Isometric Geometry: projects with
packages/hairline/src/figures/basket.ts - Figure Engines → Motion System: animates with
packages/hairline/src/figures/basket.ts - Motion System → Isometric Geometry: clamps using
packages/hairline/src/core/motion.ts - SVG Stage → Isometric Geometry: projects with
packages/hairline/src/core/stage.ts - SVG Stage → Motion System: tracks preferences
packages/hairline/src/core/stage.ts - Site Visitor → Site Pages: browses
- Site Pages → Figure Catalogue: presents
- Figure Catalogue → Catalogue Data: reads entries
apps/site/components/catalogue.tsx - Figure Catalogue → Figure Descriptions: reads descriptions
apps/site/components/catalogue.tsx - Figure Catalogue → Example Frames: renders
apps/site/components/catalogue.tsx - Figure Catalogue → React Adapter: renders figures
apps/site/components/catalogue.tsx - Site Pages → LLM Reference: serves reference
- LLM Reference → Figure Descriptions: formats
apps/site/lib/llms.ts - Registry Component → React Adapter: wraps
registry/src/hairline.tsx - Figure Author → Bench Builder: builds bench
skills/hairline-create/build.mjs - Bench Builder → Authoring Kernel: embeds
skills/hairline-create/build.mjs - Figure Author → Figure Validator: checks figure
skills/hairline-create/validate.mjs - Visual Guidance → Bench Builder: guides authoring
skills/hairline-create/look.mjs