# Common Issues

**Build fails with "No valid proto files found under components/"**<span style="white-space: pre-wrap;"> The proto submodule is not initialised. Run </span>`<span class="editor-theme-code">git submodule update --init --recursive</span>`.

**GStreamer errors at startup on Linux**<span style="white-space: pre-wrap;"> Verify the plugin path exists: </span>`<span class="editor-theme-code">/usr/lib/x86_64-linux-gnu/gstreamer-1.0</span>`<span style="white-space: pre-wrap;">. If your system uses a different architecture or distro the path in </span>`<span class="editor-theme-code">lib.rs</span>`<span style="white-space: pre-wrap;"> may need updating.</span>

**GStreamer errors at startup on Windows**<span style="white-space: pre-wrap;"> Verify GStreamer is installed to exactly </span>`<span class="editor-theme-code">C:\gstreamer\1.0\msvc_x86_64\</span>`<span style="white-space: pre-wrap;"> and that the </span>`<span class="editor-theme-code">bin</span>`<span style="white-space: pre-wrap;"> directory is in your PATH.</span>

**Video feeds show "SIGNAL LOST"**<span style="white-space: pre-wrap;"> No camera is sending data on the expected UDP ports. Start </span>`<span class="editor-theme-code">fake_camera_gstreamer</span>`<span style="white-space: pre-wrap;"> or connect the rover to get video.</span>

**White/blank window on launch**<span style="white-space: pre-wrap;"> The SvelteKit dev server may not have started yet. Wait a few seconds and the window should load. If it persists, check the terminal for Vite errors.</span>

**Model shows "Failed to load 3D model"**<span style="white-space: pre-wrap;"> In development, models are loaded from </span>`<span class="editor-theme-code">src-tauri/models/</span>`<span style="white-space: pre-wrap;">. Verify that </span>`<span class="editor-theme-code">chibiRover.glb</span>`<span style="white-space: pre-wrap;"> (or your model file) exists there. In production builds, run </span>`<span class="editor-theme-code">debug_resource_dir</span>`<span style="white-space: pre-wrap;"> from the Settings page to check where Tauri is looking.</span>

**"\[Error\] Unhandled Promise Rejection: ReferenceError: Cannot access uninitialized variable."** <span style="white-space: pre-wrap;">Seems like a circular import error, check the name of the files, some require odd names such as </span>`<span class="editor-theme-code">detected_objects.svelte.ts</span>`. If you remove the .svelte it will error out oddly.