Tonely UI Sounds

    1

    Add success, error, click and toggle sounds to any web app with tonely: no audio files, SSR-safe.

    Free

    1 useSecurity scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    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

    1. Run npm install tonely to add the required dependency.
    2. Replace your existing import { toast } from "sonner" calls with this new wrapper.
    3. 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 useTonely hook for client-side interactions.
    • Automates status mapping by linking HTTP response codes directly to audio cues via fromStatus or wrapFetch.
    • 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

    1. Install package by adding tonely to your dependencies via npm.
    2. Import singleton or hook from the appropriate entry point for your framework.
    3. Trigger sounds within event handlers, fetch wrappers, or toast notification wrappers.
    4. 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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

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

    Permissions

    Terminal / Shell
    Network Access
    Listed25 days ago

    What's inside

    Frequently Asked Questions

    Tonely uses the Web Audio API to synthesize sounds at runtime, meaning you don't have to host or load heavy MP3/WAV files, which improves page load speeds and eliminates broken asset paths.

    This skill provides the logic for the `tonely` library, which is fully compatible with React, Next.js, Vue, Svelte, and vanilla JavaScript environments.

    Yes, browser autoplay policies require a user to interact with the page (like a click) before audio can be triggered; however, this skill includes built-in handling to manage these states gracefully.

    The skill includes the `wrapFetch` utility, which allows you to automatically trigger specific sounds based on the HTTP status codes returned by your API calls.

    You receive the implementation logic for integrating the library, including specialized React hooks, global state management for volume/muting, and pre-configured audio themes like 'glass' and 'retro'.

    New in Frontend & Web Apps