diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b98cf66
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# Lollipop
+
+Opinionated key remapper that brings sticky keys functionality like Android's
+AOSP keyboard to Linux.
+
+## Core Logic
+
+Initially a key is unlatched.
+
+- Press a modifier once: Latched
+  - Press the same modifier within 500ms: Locked
+    - Press the same modifier: Unlatched
+  - Press the same modifier beyond 500ms: Unlatched