diff --git a/docs/docs/developer/setup.md b/docs/docs/developer/setup.md
index de02ab3e5..7c38066db 100644
--- a/docs/docs/developer/setup.md
+++ b/docs/docs/developer/setup.md
@@ -97,7 +97,12 @@ To see local changes to `@immich/ui` in Immich, do the following:
 
 1. Run `mise //mobile:install` to install Flutter dependencies.
 2. Run `mise //mobile:translation` to generate the translation file.
-3. Change to the `mobile/` directory and run `flutter run` to start the app.
+3. Run `mise //mobile:checkout` to update the dependencies and codegen artifacts.
+4. Change to the `mobile/` directory and run `flutter run` to start the app.
+
+:::important Workflow
+Always run `mise //mobile:checkout` after switching branches.
+:::
 
 ##### iOS Code Signing