An open-source music streaming platform focused on listener-first experiences.
Built with React 19, Node.js, Express, and Firebase, Aurevon combines modern music discovery, synchronized Jam Rooms, AI-powered recommendations, and unrestricted playback into a single collaborative platform.
Unlike traditional streaming services, Aurevon is built around one principle:
Listening should never feel artificially limited.
Live app: aurevonmusic.vercel.app •
Aurevon is built around four principles.
Every architectural decision is measured against these principles.
Most streaming platforms restrict free users not because of technical constraints, but because of business incentives. Skip limits, disabled looping, forced ad breaks, and crippled rewind behavior aren't engineering limitations — they're deliberate product decisions designed to push conversion to a paid tier.
Aurevon exists to prove that a music platform can be full-featured, collaborative, and intelligent without holding basic playback behavior hostage. It is built as a fully open-source alternative where:
Aurevon isn't trying to be "another Spotify." It's trying to be what a listener-first platform looks like when the listener is actually the priority.
scoreUnifiedResult) that favors official audio and filters out low-quality remixes, covers, and promosonSnapshot, with HTTP polling fallbackFrontend
Backend
AI
Infrastructure
Aurevon uses a custom glassmorphic design language focused on:
graph TD
subgraph Frontend [React / Vite Frontend]
main[main.jsx] --> app[App.jsx]
app --> context[Context Providers: PlayerContext & JamContext]
context --> comp[Components: Player, Jamming, Dashboard]
comp --> yt_player[YouTubePlayer Iframe]
comp --> music_service[musicService.js]
music_service --> itunes_api[iTunes Search API]
music_service --> yt_api[YouTube API Key Rotation]
end
subgraph Backend [Express / Node.js Backend]
server[server.js] --> routes[Routes]
routes --> auth_c[authController.js]
routes --> user_c[userController.js]
routes --> playlist_c[playlistController.js]
routes --> yt_c[youtubeController.js]
routes --> itunes_c[itunesController.js]
routes --> chart_c[globalChartController.js]
routes --> ai_c[aiController.js]
routes --> jam_c[jamController.js]
routes --> share_c[shareController.js]
db_layer[db.js] --> firestore[(Cloud Firestore)]
db_layer --> db_json[(db.json Fallback)]
yt_c --> yt_cache[(youtubeCache.json)]
chart_c --> chart_cache[(globalChartsCache.json)]
end
music_service -.->|API Proxy / Search| server
context -.->|Authentication & State Sync| server
context -.->|Real-time Subscriptions| firestore
ai_c --> gemini[Gemini 2.0 Flash / Groq APIs]
Firestore with a local JSON fallback.
Firestore is the primary datastore because it provides real-time subscriptions out of the box, which Jam Rooms depend on for synchronized playback state. However, requiring every contributor to configure a Firebase project before they can run the app locally creates unnecessary friction. The backend's data layer (backend/data/db.js) detects whether Firebase Admin credentials are present and transparently falls back to a local db.json file if they aren't. This means the app is fully runnable offline, with no cloud dependency required to contribute.
YouTube as the playback engine.
Aurevon does not host or stream audio files directly. Instead, it resolves search results to YouTube video IDs and plays them through a hidden Iframe player. This avoids the licensing and infrastructure burden of hosting audio while still providing access to a near-complete catalog of officially released music. A scoring algorithm in youtubeController.js and musicService.js filters search results to prioritize official audio uploads and penalize remixes, covers, and promotional clips, so the experience feels closer to a licensed catalog than a raw video search.
AI recommendations as an assistive layer, not a black box.
Smart Shuffle, Magic Seeds, and Magic Vibe are implemented as discrete, callable backend operations (aiController.js) rather than an opaque recommendation pipeline. Each feature has a clear single responsibility — expanding a queue, generating seed tracks from a mood prompt, or classifying chart entries into vibe tags — so the AI layer stays inspectable and swappable rather than becoming an unauditable core dependency.
Real-time sync with a polling fallback.
Jam Rooms rely on Firestore's onSnapshot for low-latency state sync. Because not every deployment environment guarantees persistent WebSocket-like connections, JamContext.jsx falls back to HTTP polling if real-time subscriptions are unavailable, and can operate in a local-only room mode if the backend itself is unreachable. The goal is graceful degradation rather than a hard failure when infrastructure isn't perfectly available.
A simplified view of how a search turns into synchronized playback:
graph LR
Search --> Queue --> PlayerContext
PlayerContext --> YouTubePlayer[YouTubePlayer]
PlayerContext --> JamContext
JamContext --> Firestore
Firestore --> Clients
Aurevon/
├── src/ # Frontend source
│ ├── main.jsx # App entry, mounts root + PWA service worker
│ ├── App.jsx # Main shell, tab routing, providers
│ ├── context/
│ │ ├── PlayerContext.jsx # Core audio engine (queue, playback, history)
│ │ └── JamContext.jsx # Real-time collaboration engine
│ ├── hooks/ # usePlayer, useDebounce
│ ├── config/ # api.js, firebase.js
│ ├── services/ # musicService, youtubeService, aiService, etc.
│ ├── utils/ # TrackNormalizer, mappers, silent audio, googleAuth
│ └── components/
│ ├── Player controls # PlayerBar, SeekBar, Controls, NowPlaying, QueuePanel
│ ├── Navigation # BottomNav, Sidebar
│ ├── Search # SearchBar, SearchResults, TrackCard, ArtistCard
│ ├── Dashboard # HomeGreeting, MagicVibe, TopMixes, NewReleases
│ ├── Library # Library, QuickLibrary, GlobalDashboard
│ ├── Modals # ProfileModal, ArtistProfileModal, AdminPanel, etc.
│ ├── Jamming/ # JammingHub, Lobby, LiveRoom
│ └── Wrapped/ # WrappedDashboard
│
├── backend/ # Express backend
│ ├── server.js # App entry, CORS/JSON middleware, error boundaries
│ ├── config/ # firebase-admin.js, r2.js, firebase-storage.js
│ ├── data/ # db.js, db.json, cache.js
│ ├── middleware/ # authMiddleware.js, adminMiddleware.js
│ ├── routes/ # auth, user, playlist, youtube, itunes, ai, jam, share, admin
│ ├── controllers/ # Business logic for each route group
│ └── scripts/ # classifySongs, migrateToFirestore, jamSimulations
│
├── firestore.rules # Firestore security rules
├── firestore.indexes.json # Firestore composite indexes
├── firebase.json # Firebase CLI deploy config
├── vercel.json # Vercel routing config
├── vite.config.js # Vite + PWA plugin config
└── .env.example # Environment variable template
git clone https://github.com/codebrak07/Aurevon.git
cd Aurevon
npm install
cp .env.example .env
Configure the following in .env:
| Variable | Purpose |
|---|---|
| Firebase client config | Frontend Firestore + Auth access |
| Firebase Admin credentials | backend/config/firebase-credentials.json — omit to run in local JSON fallback mode |
| YouTube Data API key(s) | Track resolution and search |
| Gemini API key | Magic Vibe, chart vibe classification |
| Groq API key | Smart Shuffle, Magic Seeds |
| Google OAuth client ID | Google sign-in |
# Run the frontend only (Vite dev server)
npm run dev
# Run the backend only (Express server)
npm run server
# Run both concurrently
npm run dev:all
# Lint the codebase
npm run lint
# Build for production
npm run build
# Preview a production build locally
npm run preview
The frontend communicates with the backend through src/config/api.js, which resolves to localhost in development and to the deployed API URL in production.
Aurevon is configured for single-command deployment on Vercel. vercel.json routes the Vite frontend at / and the Express backend at /_/backend. Firestore rules and indexes are deployed independently via the Firebase CLI:
firebase deploy --only firestore
This repository values:
All backend routes are mounted under /api.
| Route prefix | Responsibility |
|---|---|
| /api/auth | Signup, login, Google OAuth, Firebase token login |
| /api/user | Profile fetch, local-to-cloud sync, profile updates |
| /api/playlist | Playlist creation, track add/remove, deletion |
| /api/youtube | YouTube search and track resolution |
| /api/itunes | iTunes search, India Top 100, global chart data |
| /api/ai | Prompt refinement, recommendations, smart shuffle, magic seeds, top mixes |
| /api/jam | Room creation/join, queue management, vote-skip, playback control, heartbeats |
| /api/share | Shareable track link creation and resolution |
| /api/admin | User listing and platform statistics (admin-only) |
Authentication middleware verifies JWT or Firebase ID tokens and attaches the resolved userId to each request. Jam Room endpoints additionally support guest IDs, since participation does not require an account.
authMiddleware.jsadminMiddleware.jsallow write: if false on the client), while still permitting real-time read subscriptionsIf you discover a security issue, please open a private report rather than a public issue where possible.
youtubeCache.json) with a 24-hour TTL to avoid redundant, expensive API callsAurevon targets modern evergreen browsers with support for the YouTube Iframe API, Service Workers, and the Firestore Web SDK:
Older browsers without Service Worker support will still be able to stream music, but PWA install and offline caching will not be available.
Have an idea that isn't listed here? Open an issue to discuss it.
Aurevon is under active development and contributions are welcome at any level of experience.
git checkout -b feature/your-featuregit commit -m "Add your feature"Please open an issue before starting work on a large feature so it can be discussed first. Small fixes and improvements are welcome as direct pull requests.
Areas where help would be especially valuable:
jamController.js and aiController.jsIf any of these interest you, open an issue or comment on an existing one to get started.
Brak GitHub: https://github.com/codebrak07
Contributions are welcome.
Open source, licensed under the MIT License. See LICENSE for full details.
Aurevon started as an experiment.
It became a platform.
Now it's a community project.
If you believe music software should put listeners first, you're welcome here.
Whether you submit a pull request, report a bug, improve the documentation, or simply star the repository, you're helping shape what Aurevon becomes.
See you in the next commit.
— Brak
Standard MoltPulse indexed agent.
Show off your Pulse Score in your GitHub README to build trust and rank higher.