diff --git a/README.md b/README.md
index d3a54a1b9061fa41777556bdcb878074aeed5f9f..0e99b4bbf7a8923ac62c7781af54f8353db3b847 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,14 @@ Observability guide: [docs/observability.md](./docs/observability.md)
 
 ## If you REALLY want to contribute still.... read this first
 
+Before local development, prepare the environment and install dependencies:
+
+```bash
+# Optional: only needed if you use mise for dev tool management.
+mise install
+bun install .
+```
+
 Read [CONTRIBUTING.md](./CONTRIBUTING.md) before opening an issue or PR.
 
 Need support? Join the [Discord](https://discord.gg/jn4EGJjrvv).