Sound Seeker Frontend

Northcoders Software Development Final Project

Welcome to Sound Seeker, an app to help you decide which festivals to attend this summer.

Sound Seeker was developed as our group project during the final stages of our software developer course at Northcoders. This mobile application, built using React Native, leverages the Spotify and Skiddle APIs, alongside our custom backend, to provide personalised festival recommendations.

A demonstration of the app can be found here.

Features

• Search by Festival: Easily search for festivals by their name, if you already have an idea where you want to go.
• Search by Artists: Search for your favourite artists, making it simple to find festivals including them.
• Search by Location Radius: Explore festivals within a specified radius of your current location, making it convenient to attend events near you.
• Compatibility Score: We calculate a compatibility score based on your top artists and genres, sorting festival recommendations by compatibility to ensure you find the perfect match for your music tastes.
• Festival Information: View detailed information about each festival, including the lineup of artists and other essential event details.

Set up

Below are instructions on how to run our app locally. Due to the nature of the Spotify API this process is relatively lengthy, however, following the steps below should help you through the process.

1. Set Up Backend: Ensure that the backend server is up and running. You will need to set up the backend separately by following the instructions in the backend repository.

2. Clone the Repository: Clone this repository to your local machine using git clone.

3. Install Dependencies: Navigate to the project directory and install dependencies by running npm install.

4. Skiddle API: Obtain API key for Skiddle by filling out this form.

5. Create Environment Variables: Create a .env.development file in the root directory of the project and add the following variables:

     EXPO_PUBLIC_CLIENT_ID = your client id from the Spotify dashboard
   
     EXPO_PUBLIC_CLIENT_SECRET = your client secret from the Spotify dashboard
   
     EXPO_PUBLIC_REDIRECT_URI = your redirect URI from the Spotify dashboard
   
     EXPO_PUBLIC_SKIDDLE_API_KEY = ...
   
     EXPO_PUBLIC_BACKEND_API_URL = ...
   

6. Run the App: After configuring the APIs, run the app on your device or simulator using npm run start.

7. Explore and Enjoy: Once the app is running, explore the various features and functionalities to discover festivals tailored to your preferences.

Technologies Used

• React Native: Sound Seeker is built using React Native.
• Expo: Utilized for a range of handy packages including maps, secure store and authorisation.
• Spotify API: Integrated to access user's top artists and genres, personalizing festival recommendations.
• Skiddle API: Provides comprehensive information about festivals and events, enriching the app's data.

Contributors

• James Metcalfe @jamesraymetcalfe
• David Taylor @davidtaylor21
• Sebastian Murden @sjdmurden
• Tien Nguyen-Ho @m1nhnho
• Kamilla Mohamed @kamilla2424
• Rayhan Elbeera @raybeera

Feedback

We welcome feedback to enhance Sound Seeker. If you encounter issues or have suggestions for new features, feel free to open an issue.

We hope you enjoy! 🎶