The ultimate record label management platform built for modern independent labels. Manage artists, plan campaigns, track analytics, generate AI-powered content, and run complete label operations — all in one sleek React application.
LabelFlow ships with 15 fully functional modules out of the box:
| Module | Description |
|---|---|
| 📊 Dashboard | Real-time overview of label stats, activity feed, upcoming events & AI insights |
| 🎤 Artists | Manage roster cards with streaming stats, growth trends & artist profiles |
| 📣 Campaigns | Track marketing campaigns with progress bars, budgets & performance metrics |
| 📁 Assets | Filter and organise audio, images, video and document files |
| 📅 Schedule | Interactive calendar with drag-into-month navigation & upcoming events list |
| 📒 Contacts | Industry CRM — save managers, promoters, radio, press & brand contacts |
| ⭐ Opportunities | AI-powered discovery for sync deals, festivals, grants & playlist placements |
| 📝 Notes | Categorised notes editor for meetings, ideas & campaign notes |
| ✅ To-Do & Workflows | Drag-and-drop Kanban board with priority-colour task cards |
| 🤖 AI Artist Development | Generate a complete artist profile, album concept & merch line with AI |
| ✍️ AI Blog Writer | Full rich-text editor with AI content generation, chat assistant & blog library |
| 👕 AI Merch Mockups | Generate product mockups for tees, hoodies, mugs, posters & more |
| 📚 Resources | Categorised link/document library with add/delete functionality |
| 📍 Street Marketing | AI-powered city location scouting for poster drops and street activations |
| 📈 Analytics | Chart.js-powered streaming growth, audience geography & revenue mix |
Live stats, activity feed, upcoming events & AI insights at a glance.
Cards for each artist with streaming stats and growth trends.
Full rich-text editor with AI chat assistant, style selector & blog library.
Drag cards between To Do → In Progress → Review → Done columns.
Search any city for AI-recommended street marketing locations with match scores.
Chart.js streaming growth, audience geography heat map & revenue doughnut.
Create, track, and measure marketing campaigns with live progress and budget breakdowns.
Upload, filter, download, and delete audio, image, video & document files.
AI-generated product mockups — rotate angles, favourite and compare designs.
📸 Screenshots captured automatically using Puppeteer against the running dev server.
- Node.js ≥ 18 (download)
- npm ≥ 9 (bundled with Node)
# 1. Clone the repository
git clone https://github.com/RhythrosaLabs/labelflow.git
cd labelflow/labelflow-react
# 2. Install dependencies
npm install
# 3. (Optional) Configure environment variables
cp .env.example .env
# Edit .env with your values
# 4. Start development server
npm run devOpen http://localhost:5173 in your browser.
npm run build # outputs to dist/
npm run preview # preview production build locallyCopy .env.example to .env and fill in the values for any AI integrations you want to enable:
cp labelflow-react/.env.example labelflow-react/.env| Variable | Description | Required |
|---|---|---|
VITE_OPENAI_API_KEY |
OpenAI API key for live AI generation | Optional |
VITE_APP_NAME |
Overrides the app display name | Optional |
⚠️ Security: Never commit your.envfile. It is excluded via.gitignore. All API keys must be prefixed withVITE_to be exposed to the browser — never use server-side secrets in a Vite frontend.
labelflow/
├── labelflow-react/ # ← Main React app (Vite)
│ ├── public/
│ ├── src/
│ │ ├── components/
│ │ │ ├── sections/ # One file per feature module
│ │ │ │ ├── DashboardSection.jsx
│ │ │ │ ├── ArtistsSection.jsx
│ │ │ │ ├── CampaignsSection.jsx
│ │ │ │ ├── AssetsSection.jsx
│ │ │ │ ├── ScheduleSection.jsx
│ │ │ │ ├── ContactsSection.jsx
│ │ │ │ ├── OpportunitiesSection.jsx
│ │ │ │ ├── NotesSection.jsx
│ │ │ │ ├── AIArtistSection.jsx
│ │ │ │ ├── AIBlogWriterSection.jsx
│ │ │ │ ├── MerchMockupsSection.jsx
│ │ │ │ ├── ResourcesSection.jsx
│ │ │ │ ├── TodosSection.jsx
│ │ │ │ ├── SpotSpotterSection.jsx
│ │ │ │ └── AnalyticsSection.jsx
│ │ │ ├── Sidebar.jsx
│ │ │ └── MainContent.jsx
│ │ ├── App.jsx # Root component + FloatingAI
│ │ ├── labelflow.css # Core design system
│ │ └── integrated_styles.css
│ ├── index.html
│ ├── vite.config.js
│ └── package.json
├── labelflow/ # Original vanilla HTML prototype
├── ai_merch_mockup_maker_by_rhythrosa_labs/
├── cardspots___find_perfect_flyer_locations_by_rhythrosa_labs/
├── .gitignore
└── README.md
| Layer | Technology |
|---|---|
| Framework | React 19 |
| Build Tool | Vite 7 |
| Charts | Chart.js (CDN) |
| Icons | Font Awesome 6 (CDN) |
| Fonts | Google Fonts – Inter |
| Styling | Custom CSS design system (dark theme, CSS variables) |
| State | React useState / useEffect (no external state library) |
- No secrets are committed — all sensitive keys go in
.env(gitignored) - No external API calls by default — all AI responses are simulated locally, keeping the app safe to open-source
- XSS prevention — user-generated HTML is only rendered where explicitly safe via
dangerouslySetInnerHTMLon static data - No telemetry — the app makes no external network requests unless you configure an API key
- CDN integrity — Font Awesome is loaded with
integrityandcrossoriginattributes for subresource integrity
Pull requests are welcome! For major changes, open an issue first.
- Fork the repository
- Create your branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'feat: add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
This project is licensed under the MIT License — see LICENSE for details.
Built by Rhythrosa Labs — crafting tools for independent music creators.
"The music industry runs on relationships, creativity, and hustle. LabelFlow powers all three."
