SampleVault

SampleVault is a local-first sample library manager built with React, Vite, and Tauri. It scans audio folders, stores sample metadata in a local SQLite database, and supports sample preview and native file drag-out on macOS.

Requirements

• macOS with Xcode Command Line Tools (xcode-select --install)
• Node.js 18 or later and npm
• Rust and Cargo (the Rust toolchain is specified in src-tauri/Cargo.toml)

The desktop build currently targets Apple Silicon macOS. Native sample drag-out is supported on macOS.

Build the macOS app

From the project directory, run:

chmod +x build.sh
./build.sh

The script installs the locked frontend dependencies, builds the frontend, then compiles and bundles the Tauri app. The resulting app and disk image are written to:

• src-tauri/target/release/bundle/macos/SampleVault.app
• src-tauri/target/release/bundle/dmg/SampleVault_1.0.0_aarch64.dmg

To run the individual build steps instead:

npm ci
npm run build
npm run tauri build -- --bundles app,dmg

The app is unsigned unless Apple signing credentials are configured in the environment. Do not put signing credentials in project files.

Run the development app

npm ci
npm run tauri dev

To run only the frontend in a browser for UI work:

npm run dev

Tauri-specific functions, including audio playback and native drag-out, require the desktop app.

Source archive

SampleVault-V1.0.0.zip contains the project source, lockfiles, Tauri icons, and build configuration. Generated build output, installed dependencies, and Cargo target caches are excluded; they are recreated by the build steps above.