# Parallel Rooms Premium persistent music rooms for two people to share demo audio, presence, queue control, chat-style moments, reactions, ambient focus state, and memories. ## Masterplan - Deliver a calm, premium shared-listening app that feels closer to Spotify + Discord + Notion than a romantic/couple product. - Let users create or join simple room-code based sessions without authentication or backend setup. - Persist room state, queue, messages, memories, playback flags, volume, ambient mode, and listening duration through GenMB KV. - Prioritize a polished static-hosting demo over full real-time infrastructure; the UI suggests a live room, but sync is persistence-based. ## Tech Stack & Architecture - **Runtime:** Vite + React + TypeScript. - **Routing:** `HashRouter` in `src/App.tsx` for static deployments. - `/` → `src/pages/HomePage.tsx` - `/rooms/:roomId` → `src/pages/RoomPage.tsx` - `*` → `src/pages/NotFoundPage.tsx` - **Styling:** Tailwind CSS v4 via `@tailwindcss/vite` in `vite.config.ts`; design tokens and custom animation classes are centralized in `src/styles/main.css`. - **Animation:** `framer-motion` on homepage entrance; CSS keyframes for particles, gradient drift, equalizer waves, slow album rotation, fade-in, and floating reactions. - **Icons:** `lucide-react`. - **State:** No global app store. Page-local React state drives forms, loading/saving, playback, queue, and room mutations. - **Persistence:** GenMB KV SDK is injected in `index.html` as `window.genmb.kv`, typed in `src/vite-env.d.ts`, wrapped by `src/lib/roomStore.ts`. - **Providers:** `src/main.tsx` mounts ``. - `src/mainProviders.tsx` composes `ThemeProvider` and `ToastProvider`. - `ThemeProvider` persists `dark | light` to `localStorage` key `parallel-theme` and toggles `html.dark` / `html.light`. - `ToastProvider` exposes `useToast().push(...)`, renders max 4 dismissible top-right toasts, auto-removes after 4.2s. - **Audio:** `src/pages/RoomPage.tsx` uses a native `