diff --git a/README.md b/README.md
new file mode 100644
index 0000000..16d0bc0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# Expressio
+
+Generate mixed expressions, remake of [ExpGen](https://github.com/Gulantib/ExpGen)
+
+## Run the App
+
+```dotnetcli
+cd src/Expressio
+dotnet run
+```
+
+Default route for the app is [http://localhost:5289/](http://localhost:5289/).
+In development environment, a swagger for the API is also accessible through [http://localhost:5289/swagger/index.html](http://localhost:5289/swagger/index.html).
+
+## Run the test suite
+
+```dotnetcli
+cd src
+dotnet test
+```