the-beez-kneez / livefront-sutherland Goto Github PK

# Music Snob

Welcome to Music Snob! 

We all know that one person, who seems to think their taste in niche music surpasses all others.

This project is a React application that allows users to explore different genres and Music Snob will voice their opinion on your choice.

## Features

- **Genre Exploration**: Users can browse through a list of genres and select one to explore further.
- **Random Stories**: Each genre page displays a random story associated with that genre.
- **Navigation**: Users can easily navigate between genres and stories using links provided in the application.

## Technologies Used

- React
- React Router
- Axios

## API

This project utilizes the [Binary Jazz Genrenator API](https://github.com/BinaryJazz/genrenator) to fetch genres and stories dynamically.

## Setup

To run this project locally, follow these steps:

1. Clone this repository to your local machine.
2. Navigate to the project directory in your terminal.
3. Run `npm install` to install dependencies.
4. Run `npm start` to start the development server.
5. Open your web browser and navigate to `http://localhost:3000` to view the application.

## Project Structure

The project structure is organized as follows:

- `src/`: Contains the source code for the project.
  - `components/`: Contains React components used in the application.
  - `GenreFinder.jsx`: Main component for browsing genres and stories.
  - `StoryDetail.jsx`: Component for displaying story details.
  - `GenreFinder.css`: CSS file for styling GenreFinder component.
  - `StoryDetail.css`: CSS file for styling StoryDetail component.
  - `App.css`: Global CSS styles.
- `public/`: Contains public assets and HTML template.

## Testing

Unit tests for components can be found in the `src/__tests__/` directory. Tests can be run using the `npm test` command.

## Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.

## License

This project is not licensed but is a private project. The user does not permit any copying or redistribution of this project without their expressly given persmission.