From 701b75ed74ed868b5a0e756511a8d9a16f316c1c Mon Sep 17 00:00:00 2001
From: deniseismo <denisseismo@gmail.com>
Date: Fri, 7 May 2021 20:18:36 +0700
Subject: [PATCH] add README

---
 README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b394a28
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+![logo](./assets/madnessbracketfm_logo.jpg)
+
+
+[`madnessbracket.fm`](https://madnessbracket.fm) is a website where you can generate a tournament bracket for your favorite songs.
+
+### Features
+
+---
+✨ **Universal**
+
+It is no longer *just Kanye* Madness Bracket. Billie Eilish? Kendrick Lamar? David Bowie? You name it. 
+
+🤝 **Shareable**
+  
+*Any progress* can be saved: whether you've completed the bracket or just started out. Be sure to share your bracket wherever you like!
+
+🦚 **Stylish** (well, it depends)
+
+The site will render a *familiar* gradient for every track. You've guessed it right — these are the colors of the album the track is coming from.
+
+🧼 **Clean**
+
+Tracks should hopefully be void of the infamous Spotify tags (remastered, deluxe, anniversary, etc.). 
+### Usage
+
+---
+🔎 You can opt to search for *any artist you like*, or check out the *premade categories* — madnessbracket.fm will do the rest for you!
+
+☑️ The site will generate a semi-random tournament bracket, i.e. the algorithm will most likely create interesting match-ups.
+
+🎵 If you're not sure which track to advance, you can have a listen — most tracks have a preview button — all thanks to Spotify's 30-second previews.
+
+---
+Sneak peek at what *your madness bracket* might look like:
+#### Artist 
+`# Talking Heads`
+![charts](./assets/madnessbracketfm_talkingheads.png)
+#### Charts
+`# NME's 500 Greatest Songs of All Time`
+![charts](./assets/madnessbracketfm_charts.png)
+#### Secret 
+`Weekly special theme. # This week it's artists battle.`
+![secret](./assets/madnessbracketfm_radiohead_vs_muse.png)
+
+### Acknowledgements
+
+---
+The project wouldn't be possible without these incredible resources: The MetaBrainz Foundation, Last.fm, Discogs, and Spotify.
+Surely, I must mention *the origin* — the original Kanye Madness Bracket (as per Carrington Harrison's [tweet](https://twitter.com/cdotharrison/status/972880654277992450?lang=en) that went viral within the music community).
+
+### Contributing
+
+---
+Any feedback is appreciated. If you have any suggestions or found a bug, you can create an appropriate issue here, on github, or mail me at support@madnessbracket.fm.
+You can also support the project via [buying me a tea 🍵](https://www.buymeacoffee.com/seismo).
\ No newline at end of file