Skip to main content

Project Settings


SmartUI Project Settings Guide

This guide provides detailed information on how to navigate and configure the various options available in SmartUI's Project Settings. SmartUI offers a wide array of settings to customize your project, manage approvals, configure comparison parameters, and more. Before delving into the Project Settings, ensure you meet the following prerequisites:

Prerequisites for Accessing Project Settings in SmartUI

To access the Project Settings in SmartUI, you must meet the following requirements:

  1. You need an active account with LambdaTest.
  2. Ensure you have an active subscription plan with a valid screenshots limit.
  3. You must have created a project within the SmartUI web app.

To access the Project Settings, follow these simple steps:

  1. Log in to your SmartUI account and navigate to your desired SmartUI project and click on it.

  2. Click on the "Project Settings" section within the SmartUI dashboard to access the settings related to your project.

Types of Settings

SmartUI's Project Settings are organized into sections to streamline the configuration process. Here are the primary sections you'll find:

Basic Settings

cmd
  • Project Name: Customize the name of your project to enhance its identification.
info

Changing the Project Name will automatically update the smartUI.project capability's options for Web/App projects.

  • Approvers: Manage the list of authorized individuals responsible for approving changes within the project.
info

Altering Approvers will impact email notifications, which will be sent to the latest approver list for recent builds.

  • Tags: Add tags to your project for better organization and categorization.

Comparison Settings

cmd
  • Pixel Threshold: Define the pixel threshold, specifying the level of granularity for image comparisons.
info

Adjusting the Pixel Threshold in Comparison Settings will only affect new builds/screenshots captured after the update.

  • Custom Mismatch Options: Configure custom mismatch options to fine-tune the comparison process.

  • Error Highlight Color: Select a color for highlighting differences in images.

  • Bounding Boxes: Define specific regions within images for comparison, narrowing down the area of interest.

  • Ignore Pixel Scaling: Configure settings related to pixel scaling during comparisons.

  • Error Type Identifier: Choose the type of error identifier for pinpointing differences between images.

  • Transparency: Adjust image transparency settings to balance visibility during comparisons.

  • Resizing Options: Customize resizing options for images used in comparisons.

info

Changes to Project Settings will impact builds/comparisons executed after the changes and the previous builds/comparisons remain unaffected.

Additional Information:

For detailed information on these options, refer to our Comparison Settings Documentation.

Build Settings

Smart Baseline

cmd

Smart Baseline is a feature that simplifies and automates the process of updating the baseline for approved screenshots in your baseline build. This feature provides convenience and efficiency by ensuring your baseline remains in sync with approved changes without manual intervention.

cmd
  • Baseline Branch: A baseline branch build consists of screenshots captured using SmartUI. All screenshots in this build are compared against non-baseline branch builds.

  • Non-Baseline Branches: Non-baseline branch(s) builds are sets of screenshots captured using SmartUI. All screenshots in these builds are compared against the baseline build, matching them by screenshot names.

info

When Smart Baseline is turned on, the system automatically updates the baseline for approved screenshots in the baseline build, streamlining the testing process and saving time.

Warning

Please note that this feature is not supported for projects integrated with Git as Git-based projects follow a Git branching strategy.

Git Settings

Configure Git-related settings for your project, including the baseline branch name, auto-approval branches, GitHub repository linkage, and run status checks.

Additional Information:

For detailed information on these options, refer to our Git Baseline Branching Documentation.

Overwrite Screenshot

cmd
  • This feature allows to update and overwrite screenshots with the same name, ensuring that the latest version is updated for that screenshot.

  • This capability provides users with more control over the management of screenshots with identical names, enabling them to maintain accurate visual records and efficiently track changes in their application's user interface over time.

Notifications

cmd
  • Email Notification Settings: Set up and customize email notifications for build runs when changes are found and when there are changes to the list of project approvers.
note

We are continually adding more notification channels for SmartUI.

Delete Project

cmd

The "Delete Project" option allows administrators or project creators to permanently delete a project. Once a project is deleted, it cannot be retrieved.

info

Only the Admin or Creator of the project can delete a project. Once deleted, a project cannot be retrieved.