diff --git a/README.md b/README.md
new file mode 100644
index 0000000..560106e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# simple url shortener
+
+this project is a simple solution to build out a URL shortener using
+Roda, Falcon, Sequel, and SQLite
+
+the point of this project is to quickly build something and work on continuous deployment while making small refinements to the functional pieces.
+
+before running the server, you must build the database by running the following:
+
+`sequel -m db/migrations sqlite://db/url_shortener.db`