{
 "slug": "react-sounds",
 "name": "React Sounds",
 "author": "Lukas Schneider",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "A React library of ready-to-play sound effects with hooks and components, loaded from a CDN or downloaded for self-hosting.",
 "category": {
  "slug": "sound-effects",
  "name": "Sound effects"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/e3ntity.png",
 "logo_letter": "R",
 "links": {
  "repo": "https://github.com/e3ntity/react-sounds",
  "website": "https://reactsounds.com",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/react-sounds/demo.jpg",
  "alt": "All built-in sound names from the package's list, grouped into ui, notification, system, arcade, game, ambient and misc, each with its length in seconds; no sound files are played or shown.",
  "caption": "Made by AgentGid with react-sounds 1.1.0 (npm, sha512 checked), dist/manifest.json only. The package code and its sound list are MIT; the picture is our own chart of names and durations, with no sound files used."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Free and open source under the MIT license.",
   "source": {
    "label": "reactsounds.com",
    "url": "https://reactsounds.com"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
   "note": "The code is MIT; the built-in sounds have no separate license or source statement, so the repository's MIT license is the only one that applies to them.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install react-sounds. No key or account is needed.",
   "source": {
    "label": "github.com/e3ntity/react-sounds",
    "url": "https://github.com/e3ntity/react-sounds"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "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."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Unclear",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE"
    },
    "note": "Passing the code on is allowed with the MIT notice; for the sound files alone no separate permission is stated."
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-04",
  "commercial_use_page": "https://agentgid.com/assets/react-sounds/commercial-use/"
 },
 "overview": {
  "heading": "React Sounds: ready click and alert sounds for React",
  "body": "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."
 },
 "uses": [
  {
   "title": "Click sound on a button",
   "text": "Give a button, toggle or send action a short sound, so the interface feels more physical.",
   "idea": false,
   "image": null
  },
  {
   "title": "Alerts for success and errors",
   "text": "Play a chime when a form is saved and a buzz when something fails, next to the visible message.",
   "idea": false,
   "image": "https://agentgid.com/assets/react-sounds/demo.jpg"
  },
  {
   "title": "A sound on/off switch for users",
   "text": "Let people turn all sounds off; the choice is remembered in their browser for the next visit.",
   "idea": false,
   "image": null
  },
  {
   "title": "Sounds that work offline",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "Coins and level-ups in a small game",
   "text": "Use the arcade and game sounds, such as coin, jump and level up, for a browser game or a reward screen.",
   "idea": true,
   "image": null
  },
  {
   "title": "Your own sound files",
   "text": "Play your own sounds, or any sound file on the web, with the same hooks.",
   "idea": false,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add react-sounds 1.1.0 with howler, wrap the app in SoundProvider, play ui/button_soft on the main buttons and notification/success or notification/error after saving, add a Sounds on/off switch with useSoundEnabled, and only use names from the package's dist/manifest.json.",
  "install": "npm install react-sounds howler",
  "install_note": null,
  "code": [
   {
    "tab": "Step 2",
    "intro": "Play a built-in sound by its name, for example ui/button_soft or notification/success.",
    "source": "const { play } = useSound('ui/button_soft');"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "useSound('ui/button_1'), or 'ui/click', 'notification/alert' as in the docs examples",
   "fix": "Use a name from dist/manifest.json, such as 'ui/button_soft', 'ui/item_select' or 'notification/warning'",
   "why": "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.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "npm install react-sounds",
   "fix": "npm install react-sounds howler",
   "why": "Howler.js is a required peer package.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "useSoundEnabled() in a component outside SoundProvider",
   "fix": "Wrap the app in <SoundProvider> first",
   "why": "The hook throws when no provider is above it.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "useSound('https://other-site.example/sound.mp3') from a host without CORS headers",
   "fix": "Serve the file from your own site or from a host that sends Access-Control-Allow-Origin",
   "why": "The browser blocks the download otherwise.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install react-sounds",
  "repo": "https://github.com/e3ntity/react-sounds",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": null,
  "formats": [],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Sounds: react-sounds (reactsounds.com), MIT License",
  "rules_text": "- 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.\n  Connect: npm react-sounds.\n  Rule: Keep the MIT license file and copyright notice with any copies of the code or sounds you ship.\n  Rule: Install the npm package react-sounds (with howler) rather than copying files by hand.\n  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.\n  License: https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE (checked 2026-11-04; details: https://agentgid.com/assets/react-sounds/)",
  "agent_md": "https://agentgid.com/assets/react-sounds/agent.md",
  "card_json": "https://agentgid.com/assets/react-sounds/card.json"
 },
 "popularity": {
  "gid_score": 15,
  "stars": 278,
  "downloads_7d": 5886,
  "downloads_7d_label": "5,886",
  "downloads_change_4w_pct": -2.8,
  "eco": "npm",
  "package": "react-sounds",
  "repo": "e3ntity/react-sounds",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     2780
    ],
    [
     "2025-11-24",
     2212
    ],
    [
     "2025-12-01",
     2377
    ],
    [
     "2025-12-08",
     2420
    ],
    [
     "2025-12-15",
     2512
    ],
    [
     "2025-12-22",
     1049
    ],
    [
     "2025-12-29",
     985
    ],
    [
     "2026-01-05",
     1913
    ],
    [
     "2026-01-12",
     2341
    ],
    [
     "2026-01-19",
     2020
    ],
    [
     "2026-01-26",
     2266
    ],
    [
     "2026-02-02",
     2131
    ],
    [
     "2026-02-09",
     2253
    ],
    [
     "2026-02-16",
     1838
    ],
    [
     "2026-02-23",
     2183
    ],
    [
     "2026-03-02",
     3091
    ],
    [
     "2026-03-09",
     2204
    ],
    [
     "2026-03-16",
     2705
    ],
    [
     "2026-03-23",
     3343
    ],
    [
     "2026-03-30",
     3065
    ],
    [
     "2026-04-06",
     2639
    ],
    [
     "2026-04-13",
     2752
    ],
    [
     "2026-04-20",
     2873
    ],
    [
     "2026-04-27",
     3404
    ],
    [
     "2026-05-04",
     6346
    ],
    [
     "2026-05-11",
     3414
    ],
    [
     "2026-05-18",
     3412
    ],
    [
     "2026-05-25",
     3245
    ],
    [
     "2026-06-01",
     3278
    ],
    [
     "2026-06-08",
     3217
    ],
    [
     "2026-06-15",
     4615
    ],
    [
     "2026-06-22",
     4364
    ],
    [
     "2026-06-29",
     5726
    ],
    [
     "2026-07-06",
     4831
    ],
    [
     "2026-07-13",
     8292
    ],
    [
     "2026-07-20",
     8374
    ],
    [
     "2026-07-27",
     6136
    ],
    [
     "2026-08-03",
     5032
    ],
    [
     "2026-08-10",
     5770
    ],
    [
     "2026-08-17",
     6176
    ],
    [
     "2026-08-24",
     6195
    ],
    [
     "2026-08-31",
     7334
    ],
    [
     "2026-09-07",
     5369
    ],
    [
     "2026-09-14",
     5520
    ],
    [
     "2026-09-21",
     7489
    ],
    [
     "2026-09-28",
     6093
    ],
    [
     "2026-10-05",
     4705
    ],
    [
     "2026-10-12",
     4722
    ],
    [
     "2026-10-19",
     3978
    ],
    [
     "2026-10-26",
     6564
    ],
    [
     "2026-11-02",
     5899
    ],
    [
     "2026-11-09",
     5935
    ]
   ],
   "stars": []
  },
  "stars_flat_since": "2026-11-07",
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "react-sounds",
   "name": "React Sounds",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tiks",
   "name": "Tiks",
   "why": "Pick Tiks when you want interface sounds made in the browser with no sound files to download, in any framework.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "uisfx",
   "name": "UI SFX",
   "why": "Pick uisfx for 936 interface sounds in 12 styles whose files ship inside the package.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "cuelume",
   "name": "Cuelume",
   "why": "Pick Cuelume for fourteen interface cues made live in the browser and attached to elements by attributes.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "zzfx",
   "name": "ZzFX",
   "why": "Tiny JavaScript sound effects generator (under 1 KB compressed) for games; one zzfx(...) call plays a sound, with a web designer to make new ones and save them as WAV.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "jsfxr",
   "name": "jsfxr (sfxr.me)",
   "why": "Retro game sound effects generator (a JavaScript port of sfxr) with a web app and an npm library to generate, play and export 8-bit style sounds as WAV.",
   "current": false,
   "price": "Free tier",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use it in a paid app?",
   "a": "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."
  },
  {
   "q": "Does it work offline?",
   "a": "Yes, if you download the sounds into your site; it looks for local files first and falls back to the project's server."
  },
  {
   "q": "Can I load the sounds from my own server?",
   "a": "Yes. setCDNUrl sets where the built-in sound files are loaded from."
  },
  {
   "q": "Can people turn the sounds off?",
   "a": "Yes. A global on/off setting exists and is saved in the browser."
  }
 ],
 "at_a_glance": {
  "latest_version": "1.1.0",
  "last_commit": "2026-11-18",
  "runtime": "React 16.8+ (16.8, 17, 18 or 19) and howler ^2.2.3.",
  "key_needed": false
 },
 "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."
 ],
 "stack_snippets": [],
 "claims": [
  "Hundreds of ready-to-play sound effects",
  "72+ built-in sounds in the comparison table"
 ],
 "checked": {
  "license_read": "2026-11-04",
  "overview_checked": "2026-11-19",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "reactsounds.com",
    "url": "https://www.reactsounds.com"
   },
   {
    "label": "github.com/e3ntity/react-sounds",
    "url": "https://github.com/e3ntity/react-sounds"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/LICENSE"
   },
   {
    "label": "github.com/e3ntity/react-sounds/blob/HEAD/CHANGELOG.md",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/CHANGELOG.md"
   },
   {
    "label": "github.com/e3ntity/react-sounds/blob/HEAD/website/src/pages/DocumentationPage.tsx",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/website/src/pages/DocumentationPage.tsx"
   },
   {
    "label": "github.com/e3ntity/react-sounds/blob/HEAD/website/src/pages/HomePage.tsx",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/website/src/pages/HomePage.tsx"
   },
   {
    "label": "github.com/e3ntity/react-sounds/blob/HEAD/website/src/manifest.json",
    "url": "https://github.com/e3ntity/react-sounds/blob/HEAD/website/src/manifest.json"
   },
   {
    "label": "npm: react-sounds",
    "url": "https://registry.npmjs.org/react-sounds"
   },
   {
    "label": "npm: react-sounds/1.1.0",
    "url": "https://registry.npmjs.org/react-sounds/1.1.0"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/react-sounds/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
