added docs/devnotes

This commit is contained in:
thislight 2024-08-22 19:46:00 +08:00
parent 8575d51440
commit a50b57639c

15
docs/devnotes.md Normal file
View file

@ -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.