shadimage
Soundcn
blockback-001source: ok · refreshed

Back 001

A very quick, subtle sound effect suitable for navigating back in a UI or undoing a simple action.

npx shadcn add "https://soundcn.xyz/r/back-001.json"
free

Where it goes

data-table

Use cases

dashboard

Tags auto-generated by rules on 9/24/2026 — empty means no evidence, not lack of support.

Files3 · source cached 10/2/2026, 1:23:28 AM

registry/soundcn/sounds/back-001/back-001.ts
import type { SoundAsset } from "@/lib/sound-types";

export const back001Sound: SoundAsset = {
  name: "back-001",
  dataUri: "data:audio/mpeg;base64,SUQzBAAAAAAAIlRTU0UAAAAOAAADTGF2ZjYyLjMuMTAwAAAAAAAAAAAAAAD/+1DAAAAAAAAAAAAAAAAAAAAAAABJbmZvAAAADwAAAAQAAAQTAGZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZpmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZnMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM/////////////////////////////////wAAAABMYXZjNjIuMTEAAAAAAAAAAAAAAAAkBT8AAAAAAAAEE9vAUGAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA//tQxAAACGxBXHSUgAGqFmvDHvAABABU+BMExWKydHqgoBMEwTBMEwTBMEwTAwCAIAgGBQKECBGjRo2wfPwQOfh/gQ538oCAY39Ag/1HP/+nlwQdEAZ93SJEAtAqCsRQ9QAOEdHGAwEGPYMFGFSDHHE5J1DQiBHz2LESlTIcHWXketStzmczCrVacZ/oW8OXb1Wwnz6WKhbUqHJWQ3vzquLW9YkCJeJDfe1sW///8esfYfCM6GrVSYICAoJ7FfwGuOdWI4eLXxBLgEx7bXlEJv/7UsQGgAvovWIYxgABahdsgxKQAA4HtYwbiSCIhHiUeR1KAtI58b2DpgRhEMDM4WMdcTz4knCZDgXLef1/DFIjOo43nX/i5yb763VsFWr3pfabM0npm7QOiUVFQkg18Gzw0YZd/1KRtkQWBAx0YJELYYRtiklQk4ICiuDBcwToyEiFQbHBHqNdsEiEUsicyKycUIGEbf6qyJUVtro9/8IIlUKGUuj2DdZOewh9/q4xYAgQDHOKBoSuhgokab/r5+m+wyI4iLZMmAbkGbmS4ajF//tSxAeAC6y1YBjGAAGBoGoDHtAAxpMfBSMqN3OlQUCQIbT2Ia6M5KghE0tuuPw2uc9VBJhmhoTdOiqtrWu1ZPXlET9rzmTO9aZssghx4N32iItgQLhEFjH29AEAYQaa//mzIGqKY3Rvw6wG6Dn8WcSlYX4ATIKZSwZgBKBazGjwcoDZCqBvK1+CnCLC8iSic/+HKKhMhpPjC//j4XSSL5JHT3/+SJobGRsYrNTn//7GRmDIIkQ7/8JhIsTBQJAb//oJMgCJkBeAWgwksfpoqHX/+1LEBoPK0FDUPPGACAAANIAAAAQFhTqhZdWfPiDAQEKOhQE1AQFSgYUTBhQ2KLBQVgKRBQ2KLigvApgKOii4oLwKYCjoouKK4FcCnxTYorgV4V+JuLvCvCvim9/wqkxBTUUzLjEwMKqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqg==",
  duration: 0.061,
  format: "mp3",
  license: "CC0",
  author: "Kenney",
};
registry/soundcn/lib/sound-types.ts
export interface SoundAsset {
  /** Unique identifier for the sound */
  name: string;
  /** Base64-encoded data URI (data:audio/mpeg;base64,...) */
  dataUri: string;
  /** Duration in seconds */
  duration: number;
  /** Audio format */
  format: "mp3" | "wav" | "ogg";
  /** License identifier */
  license: "CC0" | "OGA-BY" | "MIT";
  /** Original author/creator */
  author: string;
}

export interface UseSoundOptions {
  /** Volume level from 0 to 1. Default: 1 */
  volume?: number;
  /** Playback speed multiplier. Default: 1 */
  playbackRate?: number;
  /** If true, calling play() stops current playback first. Default: false */
  interrupt?: boolean;
  /** If false, play() does nothing. Useful for user preferences. Default: true */
  soundEnabled?: boolean;
  /** Called when playback starts */
  onPlay?: () => void;
  /** Called when playback ends naturally */
  onEnd?: () => void;
  /** Called when pause() is called */
  onPause?: () => void;
  /** Called when stop() is called */
  onStop?: () => void;
}

export type PlayFunction = (overrides?: {
  volume?: number;
  playbackRate?: number;
}) => void;

export interface SoundControls {
  stop: () => void;
  pause: () => void;
  isPlaying: boolean;
  duration: number | null;
  sound: SoundAsset;
}

export type UseSoundReturn = readonly [PlayFunction, SoundControls];
registry/soundcn/lib/sound-engine.ts
let audioContext: AudioContext | null = null;
const bufferCache = new Map<string, AudioBuffer>();

export function getAudioContext(): AudioContext {
  if (!audioContext) {
    audioContext = new AudioContext();
  }
  return audioContext;
}

export async function decodeAudioData(dataUri: string): Promise<AudioBuffer> {
  const cached = bufferCache.get(dataUri);
  if (cached) return cached;

  const ctx = getAudioContext();
  const base64 = dataUri.split(",")[1];
  const binaryString = atob(base64);
  const bytes = new Uint8Array(binaryString.length);
  for (let i = 0; i < binaryString.length; i++) {
    bytes[i] = binaryString.charCodeAt(i);
  }

  const audioBuffer = await ctx.decodeAudioData(bytes.buffer.slice(0));
  bufferCache.set(dataUri, audioBuffer);
  return audioBuffer;
}

export interface PlaySoundOptions {
  volume?: number;
  playbackRate?: number;
  onEnd?: () => void;
}

export interface SoundPlayback {
  stop: () => void;
}

export async function playSound(
  dataUri: string,
  options: PlaySoundOptions = {}
): Promise<SoundPlayback> {
  const { volume = 1, playbackRate = 1, onEnd } = options;
  const ctx = getAudioContext();
  if (ctx.state === "suspended") {
    await ctx.resume();
  }

  const buffer = await decodeAudioData(dataUri);
  const source = ctx.createBufferSource();
  const gain = ctx.createGain();

  source.buffer = buffer;
  source.playbackRate.value = playbackRate;
  gain.gain.value = volume;

  source.connect(gain);
  gain.connect(ctx.destination);

  source.onended = () => {
    onEnd?.();
  };

  source.start(0);

  return {
    stop: () => {
      try {
        source.stop();
      } catch {
        // No-op if already stopped.
      }
    },
  };
}

More from Soundcn

Browse all components in this library →