Git runners

A runner points OneSVD at a Git repository. On every new commit, OneSVD clones the repo, runs your build, and drops the resulting artifacts into a folder in your watched tree — so your tree always holds the latest verified build.

Adding a runner#

Open the Git Runners panel, choose Add runner, and give it an SSH repository URL. Optionally set a branch; leave it blank to track the repo's default branch (OneSVD detects whether that's main, master, or something else).

git@github.com:you/your-repo.git

The runner builds into the folder you're currently viewing.

Configuring the build#

Add a .onesvd.yml at the repo root to control the build:

branch: main
build: npm run build
artifacts: dist

• branch — which branch to track (only honored if it exists on the remote).
• build — the command to run after cloning.
• artifacts — the file or directory to copy into your tree.

How updates work#

OneSVD polls the remote for new commits. When the commit changes, it rebuilds. The last-built commit only advances on a successful build, so a failed build retries on the next poll instead of being skipped.