# Lumera - Mood Tune 🎶

<p align="center">
  <img src="assets/favicon.png" alt="Lumera Logo" width="120"/>
</p>

<p align="center">
  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-18.x-green?logo=node.js" alt="Node.js Version"></a>
  <a href="#"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
</p>

---

> _"Because your song should match your mood, not because spotify said so."_

---

## 🚀 Getting Started

1. **Follow me & star this repo :)** 
2. **Clone the project**  
   ```bash
   git clone https://github.com/GithubAnant/Lumera.git
   cd Lumera
   ```
3. **Set up your Spotify API keys**

   Get your keys from [Spotify Dev Dashboard](https://developer.spotify.com/).

   Create a file named `apikeys.env`

   Inside, add:

   ```ini
   SPOTIFY_CLIENT_ID=your_client_id_here
   SPOTIFY_CLIENT_SECRET=your_client_secret_here
   PORT=10000 
   ```

4. **Install dependencies**
   ```bash
   npm install
   ```

5. **Fire up the server**
   ```bash
   node server.js
   ```

6. **Open your browser to [http://localhost:10000](http://localhost:10000) and it's live!** 🌟

---

## 📦 Installation & Usage

| Step | Command | Description |
|------|---------|-------------|
| 1 | `npm install` | Installs all the dependencies. |
| 2 | `node server.js` | Starts the magic. |

### 🧩 Dependencies

| Name                | Version   | Purpose                                  |
|---------------------|-----------|------------------------------------------|
| express             | ^4.18.2   | Web server for serving the app           |
| dotenv              | ^16.0.3   | Loads environment variables              |
| node-fetch          | ^2.6.7    | Makes HTTP requests to Spotify           |
| (and more!)         |           | See `package.json` for the full list     |


---

## ❤️ Contribute

- Open an [issue](https://github.com/GithubAnant/Lumera/issues) if you spot a bug or have a feature idea
- Tag me on [Twitter](https://twitter.com/anantsinghal807) [@anantsinghal807] if you made something cool
- Ping me on Discord: **anant.who** (I reply faster than localhost)


---

<details>
<summary>🎁 <b>Bonus: Why "Lumera"?</b></summary>

Because "Spotify Mood Thingy" was already taken. Plus, "Lumera" sounds cool. 

</details>

---

> ⚠️ Don’t forget to ⭐️ before you leave! ⭐️