Skip to content

Sidd-hant13/music-app-spotify

 
 

Repository files navigation

🎧 Stream Studio - Your Personalized Music Search Engine 🎶

Welcome to Stream Studio, a sleek and powerful music discovery platform powered by the Spotify Web API! 🚀
Search for your favorite songs, artists, and albums, and stream previews right from your browser. This project is designed to give you a seamless experience in exploring the world of music.

Whether you're a developer eager to contribute during Hacktoberfest or just a music lover, there’s something here for everyone!
Let’s build something amazing together!


🌟 Features

  1. Search by Song: Type in the name of any song, and we'll provide a list of results along with previews and details.
  2. Search by Artist: Explore an artist's entire discography, from their most popular songs to all their albums.
  3. Search by Album: Dive deep into any album and browse through all the songs in it.
  4. Stream Previews: Get a sneak peek by listening to a short audio clip from the song.
  5. Visually Stunning Interface: A polished, user-friendly UI that makes exploring music enjoyable.
  6. Pagination: Display results properly with a neat, interactive design to avoid clutter.

🛠️ Project Requirements

  • Spotify Web API: The backbone of this project, fetching all song details, including:

    • Song: Name, URL, and preview link.
    • Artist: Discover all albums and songs from your favorite musicians.
    • Album: Check out album details and all tracks within it.
    • Cover Image: Beautiful artwork for each track or album.
  • Design: A visually appealing, responsive layout.

  • Music Player: A simple music player to preview songs directly from the app.

  • Pagination: Ensure easy navigation through results.

  • Documentation: Detailed instructions for setting up and contributing.


🔧 Tech Stack

  • JavaScript / TypeScript: For handling API calls and functionality.
  • React.js: To build a seamless, interactive UI.
  • HTML/CSS: For designing a clean and engaging user interface.
  • Spotify Web API: To fetch all the music data.
  • Git/GitHub: For version control and collaboration.


🚀 Getting Started

Prerequisites

  1. Spotify Developer Account: You’ll need to sign up for a Spotify Developer account to get access to the Spotify Web API.
  2. API Key: Once registered, you’ll be able to create an app and get your Client ID and Secret for authentication.
  3. Node.js: Ensure you have Node.js installed to run the project.

🏗️ How to Contribute

I'm thrilled to invite you to contribute to Stream Studio, especially during Hacktoberfest! Follow the steps below to get started:

Contribution Steps:

  1. Fork the Repository
    Click the "Fork" button at the top right of this page to create a copy of this repository under your own GitHub account.

  2. Clone Your Fork
    Once you've forked the repo, clone it to your local machine:

    git clone https://github.com/YourUsername/stream-studio.git
  3. Create a Branch Before making changes, create a new branch to keep your changes organized:

 git checkout -b feature-branch-name
  1. Make Changes Make the necessary changes to the codebase.

  2. Commit and Push Changes After making your changes, stage and commit them:

git add .
git commit -m "Descriptive Commit Message"

Push your changes to your fork:

git push origin feature-branch-name
  1. Submit a Pull Request Once you've pushed your changes, go to the original repository and click "New Pull Request." Make sure to select your feature branch, provide a clear description of the changes, and submit the pull request. If you're contributing during Hacktoberfest, add Hacktoberfest in the description and I'll label it accordingly.

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 59.5%
  • HTML 25.6%
  • JavaScript 9.7%
  • SCSS 5.2%