Common Issues

Build fails with "No valid proto files found under components/" The proto submodule is not initialised. Run git submodule update --init --recursive . 
 GStreamer errors at startup on Linux Verify the plugin path exists: /usr/lib/x86_64-linux-gnu/gstreamer-1.0 . If your system uses a different architecture or distro the path in lib.rs may need updating. 
 GStreamer errors at startup on Windows Verify GStreamer is installed to exactly C:\gstreamer\1.0\msvc_x86_64\ and that the bin directory is in your PATH. 
 Video feeds show "SIGNAL LOST" No camera is sending data on the expected UDP ports. Start fake_camera_gstreamer or connect the rover to get video. 
 White/blank window on launch 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. 
 Model shows "Failed to load 3D model" In development, models are loaded from src-tauri/models/ . Verify that chibiRover.glb (or your model file) exists there. In production builds, run debug_resource_dir from the Settings page to check where Tauri is looking. 
 "[Error] Unhandled Promise Rejection: ReferenceError: Cannot access uninitialized variable." Seems like a circular import error, check the name of the files, some require odd names such as detected_objects.svelte.ts . If you remove the .svelte it will error out oddly.