# Danilaa1/cuelume

Cuelume is a curated sound palette, not an audio engine. It gives buttons, links, toggles, and completed actions clear feedback without asking developers to design sounds themselves. Add an attribute, call bind(), done.

Repository: https://github.com/Danilaa1/cuelume
Canonical: https://ross.abutalabs.com/products/cuelume
Homepage: https://cuelume.dev/
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-08-04T11:55:06+00:00

## Health v2 (maintenance only)
Score: 56/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 35, longevity 4
- inputs: {"age_days": 62, "days_push": 29, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1504, forks 51 (observed 2026-08-28T04:04:54.740914+00:00)

## What it is
Cuelume is a tiny TypeScript library providing seventeen curated, synthesized interaction sounds for web interfaces via the Web Audio API, with no audio files and zero runtime dependencies. Developers add data attributes to markup and call bind(), or play sounds imperatively for non-DOM moments like success and error states.

## Use cases
- add click and hover sounds to buttons and links
- play a success sound after a clipboard copy or form submission
- give toggles and switches audible feedback
- add UI sound effects without designing or downloading audio files
- enable sound preferences like volume and mute in my app
- add micro-interaction audio feedback to a web app

## When to choose
- you want polished, pre-designed interaction sounds without audio assets or an audio engine
- you need a tiny (~2kb), zero-dependency, ESM-only browser library
- you want declarative data-attribute binding plus imperative playback for async events
- your app manages its own sound settings and just needs setEnabled/setVolume hooks

## When to avoid
- you need a full audio engine, custom sound design, or music/speech playback
- you need CommonJS require() support or legacy browser compatibility
- you need server-side sound generation - playback only runs in the browser
- you want the library to persist user sound preferences for you

## Facets
- artifact type: library
- maturity: active
- function: audio-processing, ui-components, developer-tools
- domain: web-development, frontend, web-design
- platform: browser
- tags: web-audio, sound-effects, interaction-feedback, ui-sounds, synthesized-audio, esm-only, zero-dependencies, micro-interactions, ux-feedback, audio, nodejs, web-server

## Member repositories
- Danilaa1/cuelume (main) score 56

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:54.740914+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:32:43.969249+00:00, confidence not recorded.
  - readme: https://github.com/Danilaa1/cuelume (fetched 2026-08-28T04:04:54.740914+00:00, sha c380fb5b7494)
  - homepage: https://cuelume.dev/ (fetched 2026-08-29T11:37:29.056727+00:00, sha ee14f57bbf3f)
  - site_page: https://cuelume.dev/docs (fetched 2026-08-29T11:37:29.066022+00:00, sha b2f257e7c69a)
  - registry_npm: https://registry.npmjs.org/cuelume (fetched 2026-08-29T11:37:29.068006+00:00, sha fc6de1895844)
- Data as of 2026-08-30T08:39:29.467469+00:00.