supersonic-scsynth-bundle

Complete SuperSonic bundle with everything included.

What's Included

This is a convenience meta-package that includes:

• supersonic-scsynth - MIT-licensed client API (~50KB)
• supersonic-scsynth-core - GPL-licensed WASM engine + workers (~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

import { SuperSonic } from 'https://unpkg.com/supersonic-scsynth@latest';

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

SuperSonic works directly from CDN with zero configuration using the default postMessage mode. For lower latency, use mode: 'sab' which requires COOP/COEP headers.

When to Use This

Use this bundle if:

• You want a quick start with everything included
• You want access to all the Sonic Pi synths 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 | License | Contains | |---------|------|---------|----------| | supersonic-scsynth | ~50KB | MIT | Client API | | supersonic-scsynth-core | ~450KB | GPL-3.0 | WASM engine + workers | | supersonic-scsynth-synthdefs | ~67KB | MIT | 120 Sonic Pi synthdefs | | supersonic-scsynth-samples | ~34MB | CC0 | 206 Sonic Pi samples | | supersonic-scsynth-bundle | ~2KB | Mixed | Meta-package (depends on all four) |

Documentation

See the main SuperSonic repository for full documentation.

License

Mixed - see individual packages:

• supersonic-scsynth - GPL-3.0-or-later (engine) / MIT (client API)
• supersonic-scsynth-synthdefs - MIT
• supersonic-scsynth-samples - CC0