This is the frontend repo for TuneMates, a platform that make collaborative music playlists easy to maintain while keeping other from adding unwanted songs.
You can find the backend repo here.
You can find all the routes available in the application in the table below or here.
| Route | Description |
|---|---|
/ |
Landing page with app overview and features. |
/login |
User login page. |
/register |
User registration page. |
/profile |
User profile management page. |
/room/create |
Creating a new room. |
/room/slug/:slug |
Page of the room, way for everyone to request songs for a room. |
/room/slug/:slug/url |
Page of the room, way for everyone to request songs for a room by sending the URL or URI of a Spotify track. |
/room/edit/:roomId |
Editing an existing room (need to be connected ofc). |
/room/songs/:roomId |
Getting all the pending songs in a room. |
/rooms |
List of the user's rooms. |
/spotify/connect |
Redirect the user to connect their Spotify account with TuneMates. |
/spotify/callback |
Where Spotify redirect you after the connection. |
/* |
Get redirected to the error page if you don't get to any of the existing routes. |
- Clone the repository:
- Navigate to the project directory:
cd TuneMates_Frontend - Install the dependencies:
npm install
- Create a
.envfile in the root directory and add the necessary environment variables (see below). - Start the development server:
npm run dev
- Open your browser and navigate to
http://localhost:5173to view the application.
Create a .env file in the root directory of the project and add the following environment variables:
VITE_API_URL=https://localhost:7016/apiSince all the routes of the frontend are prefixed with /api, make sure to add this prefix to the VITE_API_URL variable.
- React.js
- Vite.js
- Axios
- React Router
- Tailwind CSS
Since Spotify requires a secure connection (HTTPS) for OAuth authentication, the frontend is hosted on Vercel to ensure that all communications are secure. You can visit the live application here.
So make sure to configure your backend to accept requests from this domain.
And if you want to deploy your own version of the frontend, make sure to configure your Spotify app to include your deployment domain in the Redirect URIs.