Suno Prompt Builder

Desktop app (Tauri 2 + React + TypeScript) for building Suno music-generation prompts interactively.

Features

• Slot-based composer — chip palettes for genre tags, instruments (grouped by family), vocal register, timbre, delivery, mood, dynamics, atmosphere.
• BPM slider (40–200) with free-rhythm toggle; optional named rhythm feel (4/4-driving, halftime, 6/8-lilt, …).
• Live-compiled Style string — writes Suno's two-line format following the quality rules (register first, ≤2 genre tags, etc.).
• Copy to clipboard.
• Library panel — 317 seed prompts from Suno-Prompts. Search by title, style, or body text; click to load a prompt's prose into the composer as editable custom lines.

Data source

The catalog is built at pnpm build / pnpm dev time by scripts/build-catalog.mjs, which walks the sibling ../Suno-Prompts/prompts/ directory (by-style/ and by-artist/ layouts both supported) and emits src/catalog.json. The JSON is bundled with the app — no runtime file access needed.

Override the source path with the SUNO_LIBRARY env var:

SUNO_LIBRARY=/path/to/library pnpm catalog

Run

pnpm install
pnpm tauri dev       # desktop app (first run: Rust compile, ~2–5 min)
pnpm dev             # browser-only (no Tauri shell)
pnpm build           # type-check + Vite production build
pnpm tauri build     # package desktop installer

Prompt-quality rules

Compilation follows the rules in ../Suno-Prompts/CLAUDE.md:

• Line 1: genre tags → instruments → tempo/BPM
• Line 2: vocal stack (register → timbre → delivery) → mood → dynamics → atmosphere
• Tag-style comma-separated lists
• BPM is never hardcoded in library metadata; supplied at compile time by the slider