FedVibes is a premium, ready-to-deploy independent web application built for seamless music streaming and cloud organization. Designed with a sleek dark-theme user dashboard, it offers users a complete personal audio ecosystem without any reliance on hardcoded streaming links.importing don't requires premium.

- Google OAuth Integration: Secure, plug-and-play secure user authentication flow.
- Public Spotify Sync: Automatically imports and synchronizes public playlists and followed artists directly via user profile URLs.
- Dynamic Audio Player Engine: Custom play, pause, shuffle, and progress tracking architecture.
- Cloud Sync Dashboard: Independent backend integration for persisting user library preferences.
- Fully Responsive Layout: Flawlessly optimized across mobile, tablet, and desktop viewports.
- Dark & Retro UI Modes: Includes premium interface configurations (Retro  Cassette Player deck).

- Node.js environment (v18.x or higher recommended)
- Google Cloud Console Account (for generating Web Client Google Login credentials)
- Supabase Account or any compatible relational database instance

1. Extract the contents of fedvibes-release.zip into your project directory.
2. Run "npm install" in your terminal to install all required dependencies.
3. Duplicate the provided ".env.example" file, rename it to ".env", and populate it with your unique Supabase URL, Service Role API keys, and Google Client IDs.
4. Execute the provided SQL database initialization script (found in the setup documentation) within your database SQL editor to instantly provision the required user table structures.
5. Run "npm run dev" to launch your local server instance, or "npm run build" to compile an optimized production distribution layout ready for automatic deployment on Vercel.