diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5cfd7c5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# Svelte Rest Demo
+
+Demo todo app for Svelte consuming a REST API
+
+![Screenshot](.github/screen.jpg)
+
+## 🚀 Running it
+
+```bash
+cd ./client
+yarn            # or npm i
+yarn run dev    # or npm run dev
+
+# In a different terminal
+cd ./server
+yarn 
+yarn run dev
+```
+
+The app will be served under http://localhost:3000, the server http://localhost:8000