# React Sounds — card for AI agents

A React library of ready-to-play sound effects with hooks and components, loaded from a CDN or downloaded for self-hosting.

Category: Sound effects · maker Lukas Schneider · checked 2026-11-04

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

## License
MIT — https://github.com/e3ntity/react-sounds/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/e3ntity/react-sounds/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/e3ntity/react-sounds/blob/HEAD/LICENSE)
- in app: **unclear** (Shipping inside an app unclear)

## Rules to follow
- Keep the MIT license file and copyright notice with any copies of the code or sounds you ship.
- Install the npm package react-sounds (with howler) rather than copying files by hand.
- Use the included CLI to download sounds for self-hosting if you need offline use or do not want to depend on the CDN.

## 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 react-sounds`
- Repository: https://github.com/e3ntity/react-sounds
- Website: https://reactsounds.com

## Notes
Added automatically. License read from the official pages.

## Numbers (AgentGid data)
- Gid Score: 15
- GitHub stars: 278
- Downloads last week: 5,886

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

```
- React Sounds (Sound effects). A React library of ready-to-play sound effects with hooks and components, loaded from a CDN or downloaded for self-hosting. Price: free; commercial use OK; no credit needed; shipping inside an app unclear.
  Connect: npm react-sounds.
  Rule: Keep the MIT license file and copyright notice with any copies of the code or sounds you ship.
  Rule: Install the npm package react-sounds (with howler) rather than copying files by hand.
  Rule: Use the included CLI to download sounds for self-hosting if you need offline use or do not want to depend on the CDN.
  License: https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE (checked 2026-11-04; details: https://agentgid.com/assets/react-sounds/)
```

## Links
- AgentGid page: https://agentgid.com/assets/react-sounds/
- Is it free for commercial use? https://agentgid.com/assets/react-sounds/commercial-use/
- Source: https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE
- Source: https://github.com/e3ntity/react-sounds


## React Sounds: ready click and alert sounds for React

React Sounds is a free code library that plays short ready-made sounds in React apps, such as button clicks, success chimes and game coins. It has 72 built-in sounds that load from the project's own server the first time they play. You or your AI assistant add a sound to a button with a couple of lines.

### Where to use it
- Click sound on a button: Give a button, toggle or send action a short sound, so the interface feels more physical.
- Alerts for success and errors: Play a chime when a form is saved and a buzz when something fails, next to the visible message.
- A sound on/off switch for users: Let people turn all sounds off; the choice is remembered in their browser for the next visit.
- Sounds that work offline: Download the sounds you use into your own site, so the app does not depend on the project's server and works without the internet.
- Coins and level-ups in a small game: Use the arcade and game sounds, such as coin, jump and level up, for a browser game or a reward screen. (idea, not from the official pages)
- Your own sound files: Play your own sounds, or any sound file on the web, with the same hooks.

### How to start
- Install the library together with Howler.js, which it plays the sounds with.

```
npm install react-sounds howler
```

- Wrap the app in SoundProvider to control the on/off state and preload sounds.
- Play a built-in sound by its name, for example ui/button_soft or notification/success.

```
const { play } = useSound('ui/button_soft');
```


### License
The code is under the MIT License, so it may be used in paid products; keep the copyright notice with copies. The pages do not say where the 72 built-in sounds come from or give them a separate license.

### Good to know
- By default each sound is downloaded from the project's server the first time it plays, so your app relies on that server unless you host the files yourself.
- The README headline says hundreds of sounds, while the comparison table and the package list 72 built-in ones.
- It needs React and the Howler.js audio library; it does not work in other frameworks.
- Sound files from another website play only if that site allows it with the right header.

Checked 2026-11-19 against: https://www.reactsounds.com, https://github.com/e3ntity/react-sounds, https://github.com/e3ntity/react-sounds/blob/HEAD/README.md, https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE, https://github.com/e3ntity/react-sounds/blob/HEAD/CHANGELOG.md, https://github.com/e3ntity/react-sounds/blob/HEAD/website/src/pages/DocumentationPage.tsx, https://github.com/e3ntity/react-sounds/blob/HEAD/website/src/pages/HomePage.tsx, https://github.com/e3ntity/react-sounds/blob/HEAD/website/src/manifest.json, https://registry.npmjs.org/react-sounds, https://registry.npmjs.org/react-sounds/1.1.0

### Mistakes to avoid
- Don't: useSound('ui/button_1'), or 'ui/click', 'notification/alert' as in the docs examples → Do: Use a name from dist/manifest.json, such as 'ui/button_soft', 'ui/item_select' or 'notification/warning' (The 1.1.0 list of 72 built-in names has no ui/button_1, ui/click or notification/alert; an unknown name is treated as a file path and fails to load.)
- Don't: npm install react-sounds → Do: npm install react-sounds howler (Howler.js is a required peer package.)
- Don't: useSoundEnabled() in a component outside SoundProvider → Do: Wrap the app in <SoundProvider> first (The hook throws when no provider is above it.)
- Don't: useSound('https://other-site.example/sound.mp3') from a host without CORS headers → Do: Serve the file from your own site or from a host that sends Access-Control-Allow-Origin (The browser blocks the download otherwise.)

### Questions
- Can I use it in a paid app? The code is MIT, which allows use and selling; the built-in sounds have no separate license statement on the pages, so check with the maker before shipping them in a product if that matters to you.
- Does it work offline? Yes, if you download the sounds into your site; it looks for local files first and falls back to the project's server.
- Can I load the sounds from my own server? Yes. setCDNUrl sets where the built-in sound files are loaded from.
- Can people turn the sounds off? Yes. A global on/off setting exists and is saved in the browser.

---
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.
