Harmonia | Flutter Music Streaming App with NestJS Backend and Subsequent.js Admin Panel
Launch your personal music streaming service on Android and iOS – three full initiatives in a single package deal
Harmonia is a whole, production-ready music streaming platform. Listeners get a elegant Flutter app for Android and iOS with background playback, synced lyrics, offline downloads, Chromecast and Android Auto. You get a safe NestJS + PostgreSQL backend and a Subsequent.js admin panel to run {the catalogue}, the house feed, Premium subscriptions, adverts and push notifications.
All three initiatives ship as full supply code in a single obtain. Nothing is delivered individually.
Download Demo App |
Admin Panel Demo |
Documentation
Demo logins are within the Demo Directions part beneath.
AI Disclosure
Sure, AI instruments have been used to help with elements of this merchandise: the supply code, the documentation and the preview graphics. All AI-assisted work was reviewed, edited and examined by the writer earlier than launch.
Demo Directions
Attempt the app and the admin panel before you purchase.
1. Cell App
Set up the demo app: Download Demo App
Join with any e mail handle, or proceed with Google. Premium makes use of Google Play take a look at billing within the demo, so no actual cost is taken.
2. Admin Panel
Open the admin panel demo: harmoniaadmin.pondeet.com
E-mail: [email protected]
Password: Admin@123
3. Documentation
mh152796.github.io/harnonia-docs
Characteristic walkthrough and step-by-step setup for the app, backend and admin panel, plus API reference, database schema and FAQ. Publicly accessible – no buy required.
Demo accounts are shared and the demo database is reset periodically, so any adjustments you make there are momentary.
Vital – Third-Get together Companies and Attainable Prices
Harmonia is a self-hosted package deal. You obtain the complete supply code for all three initiatives, with no licence keys and no subscription payable to us.
Some options hook up with third-party providers. These providers are not included on this buy. Each is billed to you instantly by its supplier, below that supplier’s personal phrases and pricing.
Please notice: patrons are accountable for any and all charges charged by exterior providers. This contains internet hosting, developer accounts, app retailer commissions, storage and any utilization past a supplier’s free tier. None of those charges are a part of the merchandise value, and none of them are collected by us.
- Internet hosting (required): a VPS or cloud server with Node.js 20+ and PostgreSQL 14+ for the backend and admin panel. Billed by your internet hosting supplier.
- Firebase – your personal mission (required): Authentication for app sign-in and Cloud Messaging for push notifications (firebase_core, firebase_auth, firebase_messaging within the app; firebase-admin within the backend). You create and preserve your personal Firebase mission and settle for Google’s Firebase Phrases of Service. The free Spark plan covers typical utilization; usage-based past it, billed by Google. The package deal incorporates placeholder Firebase recordsdata solely.
- Cloudflare R2 (required): shops audio recordsdata, cowl artwork and pictures uploaded from the admin panel. Features a free tier; usage-based past it, billed by Cloudflare.
- Google Play Developer account (required to publish on Android): USD 25 one-time, paid to Google.
- Apple Developer Program (solely to publish on iOS): USD 99 per 12 months, paid to Apple.
- Funds – Google Play Billing (non-compulsory): the one cost methodology included. Premium subscriptions are bought by way of Google Play, which takes a fee on each sale, usually 15-30%. The backend verifies purchases and renewals with the Google Play Developer API (googleapis), which requires your personal Google Cloud service-account credentials.
- Not included – Apple In-App Buy, Stripe, PayPal and different cost gateways: this model has no checkout integration for them. Including one is your personal growth work.
- Fb Login – your personal Fb App ID (non-compulsory): Fb sign-in (flutter_facebook_auth / Fb SDK) requires you to register your personal app at Meta for Builders and use your personal App ID and consumer token, below Meta’s Platform Phrases. Free. No Fb App ID is included.
- FFmpeg (required for stream qualities, free): put in by yourself server with its package deal supervisor (for instance
sudo apt set up ffmpeg). It isn’t bundled with the package deal. - Promoting – Google AdMob (non-compulsory): free to affix and combine; you earn income with your personal AdMob account. You’re accountable for following AdMob and Google advert community insurance policies and for any prices associated to your account or visitors. Solely Google’s official take a look at advert IDs are included.
- Expiring audio hyperlinks – Cloudflare Staff (non-compulsory): the included employee script indicators audio URLs. Features a free tier; usage-based past it.
- Music licensing (required for actual content material): it’s essential to maintain the rights, or a licence, for each observe you publish. The demo makes use of Inventive Commons music for demonstration solely; no music is included within the package deal.
The merchandise value covers the supply code and documentation solely. To go dwell you want internet hosting, your personal Firebase mission, a Cloudflare R2 bucket, and a Google Play (and optionally Apple) developer account; for Premium, your personal Google Cloud service account; for Fb sign-in, your personal Fb App ID. Each service marked non-compulsory will be neglected; the platform runs with out it, with the matching characteristic switched off. Third-party pricing is exterior our management and should change, so please test every supplier’s present charges before you purchase. We help our personal code, however we can not help, waive or refund any third-party charges or account approvals.
All the pieces Is Included within the Obtain
Your buy contains the entire supply code for all three initiatives in a single obtain. There’s nothing to request, unlock, or contact us for.
- Flutter App – full Android and iOS supply, clear structure with BLoC
- Backend – full NestJS + PostgreSQL supply, with database migrations and Swagger API docs
- Admin Panel – full Subsequent.js supply
- Documentation – characteristic walkthrough and step-by-step setup for all three, plus API reference, database schema and FAQ
Why Select Harmonia?
Constructing a streaming app, an API and an admin panel from scratch takes months. Harmonia provides you all three, already related, examined and able to customise.
- Actual streaming options: background playback, lock-screen controls, an up-next queue, crossfade, quantity normalisation, synced lyrics and a number of stream qualities.
- Constructed to earn: Premium subscriptions with free trials by way of Google Play Billing, Premium-only songs and albums, and AdMob adverts at no cost listeners.
- Managed from the admin panel: organize the house feed, banners, moods and genres, and ship push notifications with out releasing a brand new app model.
- Personalised listening: style onboarding, private “For you” sections, track radio and “You may additionally like” suggestions.
- Safe by default: the backend refuses to begin in manufacturing with placeholder secrets and techniques, applies one Premium rule on each route, verifies Google Play notifications and rate-limits each consumer.
- Clear, maintainable code: clear structure within the app, modular NestJS providers, typed Subsequent.js pages, and each surroundings variable documented.
Residence and Discovery
- Dynamic residence feed: prime hits, featured artists, standard playlists, simply arrived, moods and banners, all organized from the admin panel.
- Proceed listening and not too long ago performed: decide up any album or playlist the place you left off.
- For you: sections constructed from every listener’s style, follows, likes and listening historical past.
- Shorts: quick music clips to find new songs.
Participant Capabilities
- Background playback: media notification and lock-screen controls.
- Up subsequent queue: play subsequent, add to queue, and drag to reorder.
- Synced lyrics: comply with the phrases line by line, and share a lyric card.
- Sound management: equalizer with presets and loudness (Android), crossfade, quantity normalisation and playback pace.
- Sleep timer: cease after 5 to 60 minutes or on the finish of the observe.
- Autoplay and track radio: preserve listening to related songs when your queue ends.
- Stream high quality: computerized, Wi-Fi and cell knowledge settings, with high quality variants transformed on the server.
- Forged and drive: Chromecast help, Android Auto and a home-screen widget.
Search, Artists and Albums
- Quick search: full-text and fuzzy search throughout songs, artists, albums and playlists, with strategies and voice search.
- Trending searches: generated from actual searches, and you may pin or disguise phrases from the admin panel.
- Browse: moods, genres and curated collections.
- Artist pages: comply with artists, standard tracks, newest launch, albums, about and related artists.
- Albums and playlists: play, shuffle, save, share and obtain an entire assortment.
Shorts
- Vertical feed: swipe up by way of quick track previews, like a video feed.
- Act on a preview: like, share, comply with the artist or open the complete launch.
- Admin managed: add, edit and take away Shorts from the admin panel.
Library and Offline Listening
- Your library: playlists, saved albums, adopted artists and downloads, in a grid or listing view.
- Playlists: create, rename, add and take away songs, and make playlists public or personal.
- Offline downloads: obtain songs and albums with progress notifications, and play them and not using a connection.
- Offline search: downloaded songs keep searchable when the server is unreachable.
Monetisation
- Premium subscriptions: month-to-month plans with free trials by way of Google Play Billing, with restore purchases.
- Server-verified: purchases, renewals, refunds and cancellations are confirmed with Google by way of real-time developer notifications.
- Premium content material: mark songs, albums or playlists as Premium. Free listeners on Android see them locked; on iOS they’re hidden.
- Premium perks: ad-free listening, offline downloads and Premium-only content material, all configurable from the admin panel.
- AdMob: banner and interstitial adverts at no cost listeners, with advert unit IDs and frequency set from the admin panel.
Accounts and Settings
- Sign up: e mail and password, Google, Fb and Apple by way of Firebase Authentication. Company can hear earlier than signing up.
- Music style onboarding: decide genres and artists to form Residence and suggestions from the primary launch.
- Your units: see each signed-in system and signal any of them out remotely.
- Settings: profile and photograph, audio high quality, push notifications, theme, language and cache.
- Localisation: English and Bangla included, gentle and darkish themes, and a easy approach so as to add extra languages.
- Privateness: account deletion from the app, credit and licences display screen, and authorized hyperlinks managed from the admin panel.
Subsequent.js Admin Panel
Run the entire service from one net dashboard, with three employees roles: viewer, editor and tremendous admin.
- Dashboard: customers, lively listeners, Premium customers, performs, likes, downloads and catalogue totals.
- Songs: add audio and covers, lyrics, credit and licences, stream high quality variants and bulk add from Excel (.xlsx) or CSV.
- Albums, playlists and artists: observe pickers, Premium flags and bulk add from Excel (.xlsx) or CSV.
- Residence sections, banners, moods and genres: design the app’s residence feed and not using a new launch.
- Shorts: handle quick music clips.
- App customers: search, particulars, ban, grant or revoke Premium, and erase a person’s knowledge.
- Subscriptions and Premium plans: paying subscribers, estimated month-to-month income, plan combine, CSV export and Premium display screen copy.
- Advertisements and app config: AdMob IDs and frequency, pressure replace, upkeep mode and authorized hyperlinks.
- Push notifications: compose, goal and schedule notifications.
- Search analytics: prime and zero-result searches, clicks, and pinned or hidden trending phrases.
- Audit log and employees accounts: see who modified what, and handle admin customers and roles.
Backend Structure and Safety
The backend is constructed with NestJS 11, TypeORM and PostgreSQL, organised into clear characteristic modules.
- Manufacturing-safe configuration: the server refuses to begin in manufacturing with instance secrets and techniques or unsafe settings, and names the variable to alter.
- Protected Premium content material: one entitlement rule on each route that returns audio, plus non-compulsory expiring audio hyperlinks.
- Verified billing: Google Play purchases and notifications are checked with Google earlier than Premium is granted or eliminated.
- Hardened API: safety headers, per-device and per-IP price limits, CORS allowlist, enter validation, add checks and generic error responses.
- Media pipeline: uploads to Cloudflare R2, with stream high quality variants and loudness ranges created by FFmpeg (put in in your server, not bundled).
- Play statistics: listening classes, play counts and listening historical past that energy suggestions.
- Migrations and docs: database migrations run on deploy, with Swagger API documentation in growth.
- Configuration: each surroundings variable is documented in
.env.instance, with secrets and techniques saved out of the supply code.
What You Must Get Began
- Node.js 20 LTS or newer and PostgreSQL 14 or newer, for the backend and admin panel.
- Flutter 3.44.0 or newer and Java 17 or newer, for Android builds.
- Xcode 16 or newer and CocoaPods, for iOS builds on a Mac.
- A server to run the backend and admin panel, a Firebase mission and a Cloudflare R2 bucket.
- Primary familiarity with Flutter and Node.js is advisable for customisation.
Platform notes: the Flutter app is constructed for Android and iOS. Premium subscriptions use Google Play Billing on Android; Apple In-App Buy isn’t included on this model, so on iOS Premium is hidden by default: no Premium tab, no locked content material and no buy prompts, and iOS listeners use the free tier (Premium can nonetheless be granted from the admin panel). The equalizer and Android Auto are Android-only options.
Changelog
Model 1.0.0 (Preliminary Launch)
- Preliminary Launch
Assist
Questions earlier than or after buy? Please use the Assist tab on this merchandise web page. All help is dealt with by way of the official Envato merchandise help system.
