- Home
- Skills
- Frontend & Web Apps
- Tonely UI Sounds
Tonely UI Sounds
Add success, error, click and toggle sounds to any web app with tonely: no audio files, SSR-safe.
Free
Works with the AI Agents you already use
Tonely UI Sounds
Example session with this skill installed
Add success and error sounds to my shadcn/ui toast notifications in my Next.js project using tonely.
- Read your context and instructions
- Compiled the tonely ui sounds
I have updated the toast utility to include audio feedback using tonely. I created a wrapper that triggers the corresponding audio methods whenever a success, error, warning, or info toast is called.
Toast Sound Integration
"use client";
import { toast as sonnerToast } from "sonner";
import { tonely } from "tonely";
/**
* Enhanced toast utility that adds UI feedback sounds.
* Uses the default 'modern' theme for acoustic signals.
*/
export const toast = {
success: (message: string) => {
tonely.success();
return sonnerToast.success(message);
},
error: (message: string) => {
tonely.error();
return sonnerToast.error(message);
},
warning: (message: string) => {
tonely.warning();
return sonnerToast.warning(message);
},
info: (message: string) => {
tonely.info();
return sonnerToast.info(message);
},
message: (message: string) => {
tonely.pop();
return sonnerToast(message);
},
};
Next steps
- Run
npm install tonelyto add the required dependency. - Replace your existing
import { toast } from "sonner"calls with this new wrapper. - Add a mute toggle in your user settings using
tonely.setMuted(true).
Connects securely to your tools. The creator never sees your data.
About this skill
Web applications often feel static because adding audio feedback usually requires managing heavy MP3 assets and asset paths. This skill implements the tonely package to generate lightweight, synthesized UI sounds directly through the Web Audio API.
What it does
- Synthesizes audio by generating feedback sounds like success, error, and click at runtime without external asset files.
- Integrates hooks for React and Next.js projects using the
useTonelyhook for client-side interactions. - Automates status mapping by linking HTTP response codes directly to audio cues via
fromStatusorwrapFetch. - Manages global state including mute toggles, volume control, and audio themes like glass, retro, or minimal.
- Handles SSR safely by ensuring audio calls are no-ops on the server to prevent hydration mismatches in frameworks like Next.js.
How it works
- Install package by adding
tonelyto your dependencies via npm. - Import singleton or hook from the appropriate entry point for your framework.
- Trigger sounds within event handlers, fetch wrappers, or toast notification wrappers.
- Configure themes globally or per-call to match the application design language.
Frameworks & tools
This skill works with React, Next.js, Vue, Svelte, and vanilla JavaScript. It relies on the Web Audio API and the tonely npm package.
Why this beats prompting it yourself
Writing Web Audio API oscillators from scratch is verbose and prone to clicks or pops. This skill applies a specific set of tested audio methods and themes, ensuring consistent sound design without the overhead of asset management.
Use cases
- Add success and error chimes to form submissions and payment gateways.
- Create audio feedback for toggle switches and menu interactions.
- Enhance toast notifications with matching acoustic signals.
- Map API responses to specific audio cues using fetch wrappers.
Known limitations
Does not support music, voice, or custom audio files. Browser autoplay policies require a user gesture before sounds can trigger.
Source and latest version: https://github.com/Mostafashadow1/agent-skills (MIT licensed, free). npm: https://www.npmjs.com/package/tonely · Docs: https://tone-ly.vercel.app/. Author: Mostafa Shadow.
Requires a prior user gesture due to browser autoplay policies. Not for music or recorded audio files. Sounds are synthesized, not sampled.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 25 days ago
- Free with an Agensi account