diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3446af0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,4 @@
+# weather
+Weather data for the US
+
+Simple Weather API example using US Map SVG and openweathermap.org API.