diff --git a/codestyle.md b/codestyle.md
new file mode 100644
index 00000000..1db6ad0f
--- /dev/null
+++ b/codestyle.md
@@ -0,0 +1,7 @@
+
+# Code-style
+
+ - methods that return a promise should always use async/await
+    otherwise synchronous errors can get swallowed
+ - only named exports, no default exports
+    otherwise it becomes hard to remember what was a default/named export