b2b-music-platform

B2B music streaming platform expertise for Cloud Code. Use when discussing features, making architectural decisions, or implementing functionality for commercial venues like restaurants, hotels, retai

SKILL.md

GitHub

Cloud Code B2B Music Platform Knowledge

Business Context

Cloud Code is a B2B music streaming platform for commercial venues in Asia. It replaces BeatBreeze and competes with Soundtrack Your Brand, Rockbot, and Mood Media.

Target Users

User Type Needs
Venue Managers Easy scheduling, quick controls, mobile access
Corporate HQ Multi-venue dashboard, brand consistency, reporting
Staff Simple override controls, volume adjustment
IT/Technical API access, hardware setup, integrations

Key Differentiators

  1. Royalty-Free Content - No licensing fees, predictable costs
  2. Weather Automation - Automatic playlist switching based on conditions
  3. AI Features - Voice commands, intelligent playlist generation
  4. Affordable Hardware - $100 Raspberry Pi vs $649 competitor players
  5. Local File Support - Play customer's own content alongside library

Pricing Model

Target: $20-25/zone/month (competitors charge $35+)

Multi-Tenancy Architecture

Organization (tenant)
└── Venues (physical locations)
    └── Zones (audio outputs: lobby, restaurant, gym)
        └── Schedules, Now Playing, Messages

Critical Constraints

  1. iOS PWA Limitation: No background audio → Need native Capacitor app
  2. No Spotify/YouTube: ToS prohibits commercial use
  3. Gapless Playback: 45ms browser gaps → Use 35ms crossfades
  4. Offline Required: Venues need music even during internet outages

Feature Priorities

Phase 1 (MVP)

  • Content management (upload, organize, playlists)
  • Audio player with crossfades and ducking
  • Drag-drop scheduling calendar
  • Multi-zone dashboard

Phase 2

  • Weather automation
  • AI voice commands
  • Native iOS/Android apps
  • Advanced analytics

Phase 3

  • Generative soundscapes (Mubert integration)
  • IoT integrations (lighting, sensors)
  • White-label options

When Making Decisions

Always consider:

  • Reliability - Music must never stop unexpectedly
  • Simplicity - Venue staff are not technical
  • Cost - Keep infrastructure costs low for healthy margins
  • Offline-first - Assume internet will fail
  • Multi-tenancy - Data isolation between organizations