Developers
Fork the source.
Five capabilities live as framework-agnostic workspace packages in the public repo. They are not published to npm yet. Clone the repo and work with them locally.
5 workspace packages·MIT·npm release pending
@vibeclubs/vibe-mix
Three-layer Web Audio mixer. Ambient + music + page. Framework-agnostic, equal-power faders, duck-on-voice.
import { createMixer } from '@vibeclubs/vibe-mix'
source →@vibeclubs/pomodoro-sync
Pomodoro state machine with optional Supabase Realtime binding when the caller supplies a client.
import { createPomodoro } from '@vibeclubs/pomodoro-sync'
source →@vibeclubs/ai-witness
Claude prompt builder for session recaps. Hard-enforces "never interrupt" in the system prompt.
import { witnessPrompt } from '@vibeclubs/ai-witness'
source →@vibeclubs/session-card
SVG session card renderer. 1200×630. Deterministic from session data. Brand-locked.
import { renderSessionCardSVG } from '@vibeclubs/session-card'
source →@vibeclubs/suno-bridge
Suno API wrapper with a caller-supplied fallback. Prompt helper reads club genre + time of day.
import { generateMusic } from '@vibeclubs/suno-bridge'
source →Quickstart
Clone it. Run locally.
The repository is the public install path today. The package names exist in the workspace, but the registry releases do not.
Read the source →local checkout
git clone https://github.com/frankxai/vibeclubs
cd vibeclubs
pnpm install
pnpm --filter @vibeclubs/vibe-mix testContribute
Help ship the format.
Read CONTRIBUTING.md for style + the vetoes (no breakout rooms, no host controls, no recording-by-default, no calendar features — these are load-bearing).
Why open source
A format has to move.
If the mixer, the sync, and the recap live behind a paywall, they never travel. MIT is the only license that lets the vibeclub format spread into Electron apps, Raycast extensions, ops dashboards, and tools nobody's built yet.