# Heardlify

## Description

A game for making a guessing game out of any Spotify playlist!

Search for your favourite playlist, or browse based on your favourite artists, genres, and decades, and put your musical knowledge to the test.

Test yourself or challenge your friends!

## Screens

<img src="./public/home-screenshot.png" height="320px" />
<img src="./public/favourites-screenshot.png" height="320px" />
<img src="./public/game-screenshot.png" height="320px" />
<img src="./public/win-screenshot.png" height="320px" />
<img src="./public/local-stats-screenshot.png" height="320px" />
<img src="./public/global-stats-screenshot.png" height="320px" />

## Tech

The FE is powered by Svelte and SvelteKit, with SCSS and TypeScript.

The FE is compiled with Vite.

The BE is powered by Netlify
Functions and MongoDB.

Model validation is powered by [zod](https://www.npmjs.com/package/zod)

The BE relies on [the public Spotify API](https://developer.spotify.com/documentation/web-api/)

## Financial Contributors

Become a financial contributor and help me keep making the game even better!  
<a href="https://www.buymeacoffee.com/tomhowland">
☕ Buy me a coffee
</a>

## 🤝 Contributing

Contributions, issues and feature requests are welcome.<br />
Feel free to check [issues page](https://github.com/THowland1/heardlify/issues) if you want to contribute.<br />

## Author

👤 **Tom Howland**

- Github: [@THowland1](https://github.com/THowland1)

## Show your support

Please ⭐️ this repository if this project helped you!

## 📝 License

Copyright © 2024 [Tom Howland](https://github.com/THowland1).<br />
This project is [MIT](https://github.com/THowland1/heardlify/blob/master/LICENSE) licensed.