diff --git a/README.md b/README.md
index 67be0067b..0bde756c2 100644
--- a/README.md
+++ b/README.md
@@ -178,6 +178,14 @@ so to test them, you have to build a production build (`make deploy` and `nuxt s
 
 ### Troubleshooting
 
+#### Invalid caches after changing code
+Due to how [caches in Nitro](https://nitro.build/guide/cache) work, they automatically invalidate during development
+when their function changes. However, this heuristic does not cover other functions the cached function depends on.
+You can manually clear caches:
+```bash
+rm -rf .nuxt/cache
+```
+
 #### Module did not self-register
 
 If you encounter an error `Module did not self-register`, triggered by the `canvas` dependency,