# Tiks — card for AI agents

Open-source JavaScript library that synthesizes UI sound effects at runtime with the Web Audio API, with no audio files.

Category: Sound effects · maker Rexa · checked 2026-11-11

## Price
- Price: Free
- Free tier: Free and open source under the MIT license

## License
MIT — https://github.com/rexa-developer/tiks/blob/HEAD/LICENSE

- commercial: **yes** (Commercial use OK)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://github.com/rexa-developer/tiks/blob/HEAD/LICENSE)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
  (https://github.com/rexa-developer/tiks/blob/HEAD/LICENSE)
- in app: **yes** (Can ship inside your app)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files
  (https://github.com/rexa-developer/tiks/blob/HEAD/LICENSE)

## Rules to follow
- Keep the MIT license and copyright notice with any copies of the library you distribute.
- Call tiks.init() on or after a user gesture, and pair sounds with visual feedback.
- Use hover() sparingly; do not bind it to dense lists or menus.
- Respect prefers-reduced-motion; leave respectReducedMotion at its default of true.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How to connect
- Package (npm/PyPI)
- npm: `npm install @rexa-developer/tiks`
- Repository: https://github.com/rexa-developer/tiks
- Website: https://rexa-developer.github.io/tiks

## Notes
Added automatically; license read from the official pages.

## Numbers (AgentGid data)
- Gid Score: 18
- GitHub stars: 628
- Downloads last week: 3,610

## Lines to paste into your prompt or AGENTS.md

```
- Tiks (Sound effects). Open-source JavaScript library that synthesizes UI sound effects at runtime with the Web Audio API, with no audio files. Price: free; commercial use OK; no credit needed.
  Connect: npm @rexa-developer/tiks.
  Rule: Keep the MIT license and copyright notice with any copies of the library you distribute.
  Rule: Call tiks.init() on or after a user gesture, and pair sounds with visual feedback.
  Rule: Use hover() sparingly; do not bind it to dense lists or menus.
  Rule: Respect prefers-reduced-motion; leave respectReducedMotion at its default of true.
  License: https://github.com/rexa-developer/tiks/blob/HEAD/LICENSE (checked 2026-11-11; details: https://agentgid.com/assets/tiks/)
```

## Links
- AgentGid page: https://agentgid.com/assets/tiks/
- Is it free for commercial use? https://agentgid.com/assets/tiks/commercial-use/
- Source: https://rexa-developer.github.io/tiks
- Source: https://github.com/rexa-developer/tiks/blob/HEAD/LICENSE
- Source: https://github.com/rexa-developer/tiks


## Tiks: small interface sounds made in the browser

Tiks is a free code library that adds short interface sounds, like a click, a toggle snap or a success chime, to a website. The browser makes each sound on the spot from simple tones, so there are no sound files to download or license. It has ten sounds and four sound styles.

### Where to use it
- Click and toggle sounds: Give buttons and switches a soft tap or snap, like the sounds of a phone's own settings screen.
- Sounds without writing code: Mark buttons and checkboxes in the page with an attribute, and one call wires up all of them.
- Success and error feedback: Play a chime when a form is saved and a soft buzz on an error, always next to a visible message.
- Sounds that match your brand: Pick a soft, crisp, arcade or glass style, or set your own base pitch and wave shape for the whole app.
- A mute switch for users: Add a sound on/off switch in settings, so people who do not want sounds can turn them off.
- Two sound styles on one page: Use a quiet style for the interface and a playful one for a small game or a reward on the same page.

### How to start
- Add the package to your project.

```
npm install @rexa-developer/tiks
```

- Call init once, then play sounds from your click handlers; the sound starts working after the visitor's first click or key press.

```
import { tiks } from '@rexa-developer/tiks'

tiks.init()

tiks.click()
```

- In React, Vue, Svelte or Solid, use the matching helper instead.

```
import { useTiks } from '@rexa-developer/tiks/react'
```


### License
Free for personal and paid products under the MIT License, with no visible credit needed. The sounds are made by your visitors' browsers, so there are no sound files with their own license.

### Good to know
- Browsers allow sound only after the visitor clicks, taps or presses a key, so the first sound comes after that.
- Sounds turn off by themselves for people whose device asks to reduce motion, unless you switch that off.
- The hover sound is meant for a few chosen items; the docs warn against long lists, menus or whole areas of the page.
- The default volume is 30 percent, and volume and mute are shared by every part of the page that uses Tiks.
- It is a young project; the newest version, 0.3.0, came out in June 2026.

Checked 2026-11-19 against: https://rexa-developer.github.io/tiks, https://github.com/rexa-developer/tiks, https://github.com/rexa-developer/tiks/blob/HEAD/README.md, https://github.com/rexa-developer/tiks/blob/HEAD/LICENSE, https://registry.npmjs.org/@rexa-developer/tiks, https://registry.npmjs.org/@rexa-developer/tiks/0.3.0

### Mistakes to avoid
- Don't: tiks.click() on page load or in a timer, before any click or key press → Do: Play sounds from user actions; call tiks.init() early and let the first gesture unlock audio (The browser keeps audio suspended until the first interaction.)
- Don't: onMouseEnter={hover} on every row of a long list or menu → Do: Use hover() only on a few deliberate targets, or not at all (The docs warn against dense hover targets; the engine throttles hover to one tick per 80 ms.)
- Don't: tiks.init({ respectReducedMotion: false }) to make sure sounds always play → Do: Leave respectReducedMotion at its default true and offer a mute switch (People who ask their device for reduced motion get silence by default; turning that off overrides their choice.)
- Don't: A sound as the only sign that something failed → Do: Show the error message and play error() with it (Sounds are meant as an extra layer, never the only feedback.)
- Don't: <button aria-pressed> with data-tiks="toggle" whose attribute is updated after the click handler → Do: Update aria-pressed before the handler returns, or use data-tiks="toggle-on" / "toggle-off" (The toggle binding reads aria-pressed to pick the rising or falling sound.)

### Questions
- Can I use it in a paid app? Yes. The MIT License allows use, copying and selling; keep the copyright notice with copies of the code.
- Which sounds are included? Ten, click, toggle on and off, success, error, warning, hover, pop, swoosh and notify, in four styles.
- Does it work without React? Yes. It works in plain pages, and has helpers for React, Vue, Svelte and Solid.
- Do the sounds play for everyone? Not for people whose device asks to reduce motion, unless you turn that check off, and only after their first click or key press.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
