diff --git a/docs/devnotes.md b/docs/devnotes.md
new file mode 100644
index 0000000..100207d
--- /dev/null
+++ b/docs/devnotes.md
@@ -0,0 +1,15 @@
+# Dev Notes
+
+This file documents some advices working on the app.
+
+## Debugging for iOS
+
+You can debug on the Safari on iOS only if you have mac (and run macOS). The certain workarounds don't work well. Here are some tips:
+
+- [GNOME Web (epiphany)](https://apps.gnome.org/Epiphany/) uses webkit2gtk, the same engine from Safari. Most of bugs can be reproduced on it.
+- For visual bugs: on you iDevice, redirect the localhost.direct to your dev computer. Now you have the hot reload on you iDevice.
+  - You can use network debugging apps like "Shadowrocket" to do such thing.
+
+## Hero Animation won't work (after hot reload)
+
+That's a known issue. Hot reload won't refresh the module sets the hero cache. Refresh the whole page and it should work.