# SongGuessr 🎵

A fun and interactive music guessing game built with Next.js. Test your musical knowledge by identifying songs from audio clips!

## Features

-   🎧 Audio-based song identification
-   🎮 Interactive gameplay interface
-   📱 Responsive design for all devices
-   ⚡ Fast and smooth user experience with Next.js

## Getting Started

### Prerequisites

Make sure you have Node.js installed on your machine.

### Installation

1. Clone the repository

```bash
git clone https://github.com/RafaeloxMC/songguessr.git
cd songguessr
```

2. Install dependencies

```bash
npm install
# or
yarn install
# or
pnpm install
```

3. Set up environment variables

```bash
cp .env.example .env
```

Edit the `.env` file with your configuration values.

### Development

Run the development server:

```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```

Open [http://localhost:3000](http://localhost:3000) with your browser to see the application.

You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.

## Project Structure

```
songguessr/
├── public/          # Static assets
├── src/            # Source code
│   ├── app/        # Next.js app directory
│   └── ...         # Other source files
├── .env            # Environment variables
└── ...
```

## Built With

-   [Next.js](https://nextjs.org/) - React framework for production
-   [TypeScript](https://www.typescriptlang.org/) - Type-safe JavaScript
-   [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework (if applicable)

## Scripts

-   `npm run dev` - Start development server
-   `npm run build` - Build for production
-   `npm run start` - Start production server
-   `npm run lint` - Run ESLint

## Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Acknowledgments

-   Thanks to all the music artists whose songs make this game possible
-   Built with love for music enthusiasts everywhere

## Use of AI in project

AI helped me create this project. It was used for repetitive code tasks and for providing data for playlists.

---

Made with ❤️ and 🎵