diff --git a/README.md b/README.md
new file mode 100644
index 0000000..52fd4e3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# SlowDowner
+music web player with slowdown option
+
+
+## Dependencies
+### Yarn
+This project uses Yarn as package manager, to install all needed dependencies run
+``` yarn ```
+in the project directory
+
+### Development
+to run the test server locally run
+``` yarn run start ```
+and in another terminal
+``` yarn run dev ```