diff --git a/README.md b/README.md
index fc676be..6b1631b 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,15 @@
-# yawn
\ No newline at end of file
+# yawn
+
+## accepted plans
+- most of the logic in service workers
+- ts / webgl based
+- as declarative as possible
+- no backwards compatibility until v1.0
+- as much geometric algebra as reasonable
+- 
+
+## planned features
+- 
+
+## 
+-