Skip to main content

Push saved edits

Save changes in each open KiCad editor before clicking BoardRepo: Push or Pull. The plugin reads the project’s saved files on disk. On first use, choose the existing BoardRepo project or create one. For an existing board, your account needs permission to download its source and publish a new version. Check the destination and files, enter an optional version message, then confirm Push. Open the board’s version history, verify the new version, and share that revision for review. If Push reports an open change request, keep your local files and open the linked request. An authorized collaborator must close or merge it before a direct Push can succeed. If the merge advanced the board, reconcile the new revision with your local work before starting another Push.

Pull the current version

Save your open editors. To keep independent local edits, copy the saved project outside the synchronized folder before starting. Pull replaces the synchronized files in your local project with the current BoardRepo version. For an older revision, download its source from the board’s version history instead.
  1. Open the toolbar action, check the board and version, and confirm Pull.
  2. Follow the plugin’s reload or close instructions for every affected editor. When prompted, use File → Revert to load the pulled files from disk. When first connecting to an existing board, you may need to close the project in both editors.
  3. Check that the pulled design is visible before confirming. An editor can still show the previous design after the files on disk have changed.

Recover an interrupted Pull

Open BoardRepo: Push or Pull again to resume recovery. Keep the recovery folders in place. If you choose Undo Pull, close the affected editors when prompted. Undo restores the previously saved files. Edits that existed only in editor memory cannot be recovered this way.