From d7a2cff6397eb5a34899cc6ef34cdb906fa9b89b Mon Sep 17 00:00:00 2001
From: Himadri Bhattacharjee <107522312+lavafroth@users.noreply.github.com>
Date: Sat, 10 Jan 2026 09:10:34 +0530
Subject: [PATCH] docs: add readme

---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 README.md

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