diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f5f3b52
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Cloud native motion detection microservice
+
+This software implements the motion detection portion
+of well known [motion-project](https://motion-project.github.io/) as
+a microservice. For the tiling counterpart see `camera-tiler` repository.
+
+In a nutshell:
+- It brings the MJPEG stream into the cluster
+- Performs highly optimal JPEG DCT coefficient based motion detection
+  without actually decoding the JPEG frame to a bitmap
+- WIP: Writes events to MongoDB
+- WIP: Uploads screenshots to S3
+- Exposes endpoint for distributing MJPEG stream inside the cluster,
+  eg by the `camera-tiler`
+- Exposes endpoint for inspecting DCT blocks where motion has been detected