Advice and answers from the Team

  1. Visit your board's "Settings" screen and click on the "Sources" tab
  2. Under "Add New Source" click on the appropriate type of source you wish to add (currently, Waffle supports SaaS GitHub repos by default, with the capability to support GitHub Enterprise repos with a bit of additional setup)
  3. Scroll through the list of repositories and select the one you wish to add to your board (you can always delete sources from your board in the future)

There are some limitations and "gotchas" of the multi-repo feature:

  • The "primary source" on a board is the initial repository to which it was linked. This repository is the one reflected in the URL of the board.
  • A "source" is a repository from which data is fed from GitHub to your Waffle board.
  • When you add multiple sources to a board, the primary source can no longer be accessed by itself. In order to again access the primary source by itself, you will need to remove the secondary repositories from the board.
  • If you access a board for a source that exists as a source on a different board, make sure the columns match. If you don't, you’ll see cards skip columns or move to the backlog for the multi-repo board.

Permissions work as follows:

  • For a public repo as the primary source, you will need to be a collaborator on that repo to see any private sources. Non collaborators and logged out users will not see your private sources.
  • If you are not a collaborator of a source, you may be allowed to attempt a change, but the add/edit will fail.

For additional information (and helpful pictures), check out our blog post on multi-repo support.

Did this answer your question?