supersonic-scsynth-bundle

Complete SuperSonic bundle with everything included.

What's Included

This is a convenience meta-package that includes:

• supersonic-scsynth - The core scsynth WASM engine (~450KB)
• supersonic-scsynth-synthdefs - All 120 Sonic Pi synthdefs (~67KB)
• supersonic-scsynth-samples - All 206 Sonic Pi samples (~34MB)

Installation

npm install supersonic-scsynth-bundle

This installs all three packages as dependencies.

Usage

Important: SuperSonic cannot be loaded from a CDN. You must self-host the core library and serve it with COOP/COEP headers. See the main README for details.

import { SuperSonic } from './dist/supersonic.js';

// Synthdefs and samples can use CDN
const supersonic = new SuperSonic({
  sampleBaseURL: 'https://unpkg.com/supersonic-scsynth-samples@latest/samples/',
  synthdefBaseURL: 'https://unpkg.com/supersonic-scsynth-synthdefs@latest/synthdefs/'
});

await supersonic.init();
await supersonic.loadSynthDefs(['sonic-pi-beep', 'sonic-pi-tb303']);

When to Use This

Use this bundle if:

• You want a quick start with everything included
• You're building a Sonic Pi-compatible application
• You want the Sonic Pi synthdefs and samples

Use separate packages if:

• You want minimal package size (just install supersonic-scsynth)
• You have your own synthdefs and samples
• You're building for production and want fine-grained control

Package Breakdown

| Package | Size | Contains | |---------|------|----------| | supersonic-scsynth | ~450KB | Core WASM engine | | supersonic-scsynth-synthdefs | ~67KB | 120 Sonic Pi synthdefs | | supersonic-scsynth-samples | ~34MB | 206 Sonic Pi samples | | supersonic-scsynth-bundle | ~2KB | Meta-package (depends on all three) |

Documentation

See the main SuperSonic repository for full documentation.

License

GPL-3.0-or-later