https://github.com/parwatcodes/song-discovery
Song discovery app using Discogs API
https://github.com/parwatcodes/song-discovery
Last synced: 6 months ago
JSON representation
Song discovery app using Discogs API
- Host: GitHub
- URL: https://github.com/parwatcodes/song-discovery
- Owner: parwatcodes
- Created: 2025-01-25T01:49:03.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-01-31T06:13:51.000Z (11 months ago)
- Last Synced: 2025-02-05T11:51:21.430Z (11 months ago)
- Language: TypeScript
- Homepage: https://songs-discovery.vercel.app/
- Size: 181 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Song Discovery
## Detailed documentation
https://docs.google.com/document/d/1H2BgyWttFu6OacthIx3BD2SieEHswNeIH8Vwmuf7bg4/edit?usp=sharing
## Overview
Song Discovery is a web application that allows users to discover new music albums. Users can filter albums by year, genre, and country, and view album details, bookmark albums, songs, artists to their favs.
https://songs-discovery.vercel.app/
## Features
- Browse and discover new music albums
- Free search for Artist, Albums, genre, country and many more
- Filter albums by year, genre, and country
- View Artists and their albums
- View album details
- Add albums to favorite and view them from albums page or a separate Favorite page
## Technologies Used
- React
- TypeScript
- React Query (for state management, caching and many more)
- Styled Components
## Client Routes
The Song Discovery app uses React Router for client-side routing. Here are the main routes:
- Home (/): The home page where users can search and filter albums.
- Album Details (/album/:id): The page that displays detailed information about a specific album.
- Artist Details (/artists/:id): The page that displays detailed information about a specific artist and their albums.
- Favorite (/favorites): The page that displays the user's favorite albums and artists.
## Getting Started
### Installation
1. Clone the repository:
```sh
git clone https://github.com/parwatcodes/song-discovery.git
cd song-discovery
2. Install dependencies:
```sh
npm install
# or
yarn install
3. Create a .env.local file in the root directory and add your API base URL:
```sh
# .env.local
VITE_DISCOGS_API_KEY=YOUR_API_KEY
VITE_DISCOGS_API_SECRET=YOUR_API_SECRET
VITE_DISCOGS_TOKEN_URL=https://api.discogs.com/oauth/request_token
VITE_DISCOGS_AUTHORIZE_URL=https://www.discogs.com/oauth/authorize
VITE_DISCOGS_ACCESS_TOKEN_URL=https://api.discogs.com/oauth/access_token
VITE_DISCOGS_BASE_URL=https://api.discogs.com
### Running the Application
1. Start the development server
```sh
npm run dev
2. Open your browser and navigate to http://localhost:5173.