Cloning the Repository

Before cloning the repository, install the following tools on your machine.

The repository contains a Git submodule for the protobuf definitions. You must clone with --recurse-submodules or the src-tauri/proto/ directory will be empty and the build will fail.

git clone --recurse-submodules https://github.com/RoboTeamTwente/erc-software-basestation.git
cd erc-software-basestation

If you already cloned without the flag, initialise the submodule manually:

git submodule update --init --recursive

Keeping the submodule up to date

When pulling changes that include submodule updates, always run:

git pull
git submodule update --recursive

If the proto definitions change and your build starts failing with protobuf-related errors, this is almost always the cause.

Installing Frontend Dependencies

bun install

This reads package.json and installs all SvelteKit, Threlte, and other frontend dependencies into node_modules/. Run this once after cloning and again whenever package.json changes.