tuman06

🎶 musicpedia - Discover Music Effortlessly

📋 Introduction

This document guides you to download and run the musicpedia application on your local machine. It is designed for easy use, even if you have no programming background. Follow the steps carefully, and you will have the application running within minutes.

🚀 Getting Started

Before you start the installation, ensure your device has the following software installed:

1. Git: This tool helps you get the code from GitHub.
2. PHP: Version 8.2 or higher is required to run the application.
3. Composer: This is a dependency manager for PHP that makes installation easier.
4. Node.js & NPM: These are essential for managing and compiling frontend assets like JavaScript and CSS.
5. Local Web Server: You can use software like Laragon, XAMPP, or similar to host the application locally.

📥 Download & Install

Visit this page to download: Download Musicpedia

Step 1: Clone the Project from GitHub

1. Open the terminal or command prompt on your computer.
2. Navigate to the directory where you want to save the project.

3. Run the following command:

   git clone https://github.com/madasepandri/musicpedia.git
   

4. After the cloning process is complete, move to the newly created project directory:

   cd musicpedia
   

Step 2: Install Dependencies

In the project directory, run the following command to install the required dependencies using Composer:

composer install

Step 3: Set Up the Frontend

Now, you need to install the frontend assets. Run the following command to install Node packages and compile your assets:

npm install
npm run build

Step 4: Configure the Web Server

Set up your local web server to point to the musicpedia directory. This can be done through your server’s interface. Make sure to configure the document root to the public directory inside musicpedia.

Step 5: Start the Web Server

Once your web server is configured, start it. You should be able to access the application by navigating to http://localhost/musicpedia/public in your web browser.

🌟 Explore Musicpedia

Once you have set up the application, you can start exploring. musicpedia will allow you to search for information about songs, artists, and albums. The interface is user-friendly and intuitive, making your music discovery experience enjoyable.

For further instructions and code explanations, refer to the JOBSHEET.md file located in the project directory.

🛠 Troubleshooting

If you encounter any issues during installation, check the following:

• Ensure that all prerequisites are installed properly.
• Verify that your local web server is running.
• Confirm that you have navigated to the correct directory in your terminal.

📣 Feedback and Contributions

If you have ideas or suggestions for improving the musicpedia application, feel free to create a pull request. Your contributions are welcome and appreciated.