ghwmelite-dotcom/Melodia

AI-powered music generation platform — from a simple idea to a fully produced song with lyrics, vocals, instrumentation & album artwork. Built for Africa by OHWPStudios. # MELODIA ### AI-Powered Music Generation Platform **From a simple idea to a fully produced song — lyrics, vocals, instrumentation, and album artwork.** **All powered by AI. Built for Africa.** --- *"Afrobeats love song about Accra at night"* *That's all it takes.* --- ## What is Melodia? Melodia is an AI music generation platform that takes a user from a simple mood or idea to a **fully produced, radio-ready song** — complete with lyrics, vocals, instrumentation, and album artwork. Think of it as having a **Grammy-winning songwriter**, a **world-class producer**, and a **professional graphic designer** on call 24/7. You provide the spark. The AI does everything else. **Target Market:** Africa, starting from Ghana. --- ## Architecture ``` User Input → Cloudflare Worker (orchestrator) ├── Step 1: LLM Lyrics Engine (Workers AI) ├── Step 2: Music Generation (ACE-Step 1.5 — External GPU) ├── Step 3: Album Artwork (Workers AI — FLUX.2) ├── Step 4: Post-Processing (metadata, waveform, storage) └── Step 5: Delivery (R2 → CDN → User via WebSocket) ``` ### Monorepo Structure ``` melodia/ ├── apps/ │ ├── api/ → Cloudflare Workers (Hono) │ └── web/ → React 19 + Vite + Tailwind CSS 4 ├── packages/ │ └── shared/ → Valibot schemas, types, constants └── docs/ └── superpowers/ → Design specs & implementation plans ``` --- ## Tech Stack | Layer | Technology | Purpose | |-------|-----------|---------| | **API** | Hono on Cloudflare Workers | Edge-native API framework | | **Database** | Cloudflare D1 (SQLite) | Users, songs, playlists, credits | | **Cache / Rate Limiting** | Cloudflare KV | Rate limits, OAuth state, OTP codes | | **Storage** | Cloudflare R2 | Audio files, artwork, stems | | **Frontend** | React 19 + Vite 6 | SPA with code-split routing | | **Styling** | Tailwind CSS 4 | Dark theme, custom design tokens | | **Validation** | Valibot | Shared schemas (API + frontend) | | **Auth** | Web Crypto API | PBKDF2 password …