diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ddc4e4e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# sfshows
+
+* see https://metasyn.pw/shows
+* parses [the list](http://www.foopee.com/punk/the-list/) via [show-scraper-rs](https://github.com/metasyn/show-scraper-rs)
+* uses mapbox, react