Set a Base Preview

Whether you want to set one Base Preview, or set multiple Base Previews, the process is the same:

How to set a Base Preview

To create a Base Preview, you’ll first need to have a Preview build to serve as your starting point.

  1. Go to username -> My Projects at the upper-right of the Tugboat screen.
  2. Select the project where you want to set a Base Preview.
  3. Click the name of the repo that contains Preview you want to use as a Base Preview.
  4. Find the Preview you’d like to set as a Base Preview, and go into Settings for that Preview.
  5. Click the checkbox next to Use this Preview as a Base Preview.
  6. Select the Base Preview Type. For more about Base Preview types, see: Base Preview Auto Select.
  7. Press the Save Configuration button.

That preview will be moved to the Base Preview section of the Repository Dashboard. From now on, Previews that match the Base Preview type will build from the snapshot created when that Base Preview was built.

Visual Walkthrough

Go to username -> My Projects at the upper-right of the Tugboat screen.

Go to username -> My Projects Go to username -> My Projects

Select the project where you want to set a Base Preview.

Select the project Select the project

Click the name of the repo that contains Preview you want to use as a Base Preview.

Select the Tugboat repository Select the Tugboat repository

Find the Preview you’d like to set as a Base Preview, and go into Settings for that Preview.

Go into Settings for the Preview you want to use as a Base Preview Go into Settings for the Preview you want to use as a Base Preview

Click the checkbox next to Use this Preview as a Base Preview.

Click the checkbox to set this Preview as a Base Preview Click the checkbox to set this Preview as a Base Preview

Select the Base Preview Type. For more about Base Preview types, see: Base Preview Auto Select.

Click the radio button next to the appropriate Base Preview Type Click the radio button next to the appropriate Base Preview Type

Press the Save Configuration button.

Press the Save Configuration button to save changes Press the Save Configuration button to save changes

That preview will be moved to the Base Preview section of the Repository Dashboard.

View of Base Preview in repository View of Base Preview in repository

If you’re ever wondering which Base Preview was used when generating a Preview, check under the name of the Preview; you’re looking for the “from Base Preview Name”:

View Base Preview for Preview View Base Preview for Preview

Add multiple Base Previews

You can add multiple Base Previews to a project, following the directions outlined above.

Set multiple Base Previews Set multiple Base Previews

When you’ve set multiple Base Previews, every new Preview build (including automated builds from pull requests) will create a build from all Base Preview Types that match the new Preview build. For more information on Base Preview matching, see: Base Preview Auto Select.

In my sample project, I’ve set two Repository Base Previews, and building a Preview from a new PR automatically created two Previews - one for each Base Preview.

Multiple Base Previews generating multiple Preview builds Multiple Base Previews generating multiple Preview builds