react-sounds
v1.2.0
Published
A library of ready-to-play sound effects for React applications.
Maintainers
Readme
react-sounds 🔊
✨ Why react-sounds?
- 🪶 Lightweight: Only loads JS wrappers, audio files stay on CDN until needed
- 🏗️ Lazy Loading: Sounds are fetched only when they're used
- 📦 Offline Support: Download sounds for self-hosting with the included CLI
- 🎯 Simple API: Intuitive hooks and components
- 🔊 Extensive Library: Hundreds of categorized sounds (UI, notification, game)
How does react-sounds compare?
| | react-sounds | use-sound | howler.js | |---|---|---|---| | Built-in sounds | 72+ | None | None | | React hooks & components | Yes | Hooks | None | | Bundle impact | ~0 KB (CDN-loaded) | User-bundled | ~7 KB gzipped | | TypeScript | Built-in | Built-in | @types | | Next.js ready | Yes | Manual setup | Manual setup | | Last release | Mar 2026 | Feb 2025 | Sep 2023 |
react-sounds wraps howler.js and adds a curated sound library, React components, and zero-config CDN delivery. use-sound and howler.js are great standalone options if you bring your own audio files.
🚀 Quick Start
npm install react-sounds howler
# or
yarn add react-sounds howlerimport { useSound } from 'react-sounds';
function Button() {
const { play } = useSound('ui/button_1');
return (
<button onClick={() => play()}>
Click Me
</button>
);
}Your own sounds and sound packs
Any MP3 URL works (cross-origin files need CORS headers):
const { play } = useSound('https://cdn.example.com/sounds/whoosh.mp3');Or add a sound pack, a manifest.json listing MP3 files by name. The CLI writes the manifest and TypeScript types into your app:
npx react-sounds-cli add https://openfoley.com/c/ui-sounds # add --download to copy the files into public/import uiSounds from './sounds/ui-sounds.json';
<SoundProvider packs={[uiSounds]}>...</SoundProvider> // or registerSounds(uiSounds)
const { play } = useSound('ui-sounds/bright-success-chime'); // typed and autocompletedTurn a folder of your own MP3s into a pack with npx react-sounds-cli pack ./my-sounds.
🎨 More Sounds
Need a sound that isn't built in? openfoley is an open library of CC0 sound effects and sound packs that work with react-sounds out of the box. You can also generate new sounds there with AI.
📚 Documentation
For complete documentation including advanced usage, visit reactsounds.com/docs
🎮 Live Demo
Try the interactive demo at reactsounds.com
🔍 Explore All Sounds
Browse and play all available sounds at reactsounds.com/sounds
💻 Browser Support
Works in all modern browsers that support the Web Audio API (Chrome, Firefox, Safari, Edge)
📄 License
MIT © Lukas Schneider
