Skip to content

noisefactorllc/handfish

Repository files navigation

Handfish Design System

A modern, accessible component library for creative tools. Built with Web Components and CSS Custom Properties.

Docs & API Reference: handfish.noisefactor.io

Live Demo: handfish.noisefactor.io/examples/

Quick Start

<link rel="stylesheet" href="https://handfish.noisefactor.io/0/styles/index.css">

<script type="importmap">
{ "imports": { "handfish": "https://handfish.noisefactor.io/0/handfish.esm.min.js" } }
</script>

<script type="module">
import { ToggleSwitch, SliderValue, ColorPicker } from 'handfish'
</script>

Pinning levels

The CDN exposes three URL shapes so you can choose how much drift between deploys your application tolerates:

URL shape Meaning When to use
handfish.noisefactor.io/0 Rolling latest within major 0. Automatically tracks every minor and patch release until a 1.0 ships; at that point /0 freezes and consumers explicitly migrate to /1. Most integrations. No code change needed for minor upgrades.
handfish.noisefactor.io/0.10 Rolling latest within the 0.10 minor series. Stays on 0.10.x even if 0.11 or 1.0 ships. Patch-level updates with explicit control over minor upgrades.
handfish.noisefactor.io/0.10.1 Exact pin, immutable. Contents never change once published. Reproducible builds, frozen historical versions.

The Quick Start above uses /0 — substitute any of the shapes in the table. The examples on the handfish docs page all use /0 as well.

Development

npm install
npm run dev
# Open http://localhost:3000/examples/

Testing

npm test              # Visual regression tests
npm run test:update   # Update baselines

License

MIT

About

UI components and styles

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors