SmoothDeploy Docs

Projects

Create and configure projects to scope your tests.

Projects group related tests and shared steps together and provide the default Playwright configuration applied when no per-run overrides are set. Tests and steps belong to exactly one project and cannot be shared across projects.

In the sidebar, click Organization → Projects.

Project List

The list shows all projects in your organization with their name and last-updated date. Click a project name to open its detail page.

Each row has two controls in the Actions column:

  • A Select button (shown as Current and disabled when already active) — makes that project your active project.
  • An ellipsis menu with:
    • Edit Project — opens the project edit page. Visible to admins and owners only.
    • Set as Current / Current Project — same action as the Select button.
    • Delete — opens a confirmation dialog. Visible to admins and owners only.

Create a Project

Admins and owners can create projects. Click New Project to open the form.

FieldRequiredNotes
Project NameyesUp to 32 characters
DescriptionnoUp to 500 characters
StatusyesActive or Archived
Set as active project for current user—Makes this project active in the navbar after creation

Click Create Project to save. Creating a project requires an active license.

Project Detail

Click a project name in the list to open the detail page. The page shows the project name, description, and created/updated timestamps.

Click Edit to switch to inline editing mode. Click Save to apply changes or Cancel to discard them.

Deleting a project is permanent

Click Delete to open the confirmation dialog. Deleting a project permanently removes the project and all its tests, steps, and run history.

Edit a Project

Click Edit Project in the row's ellipsis menu to open the project edit page. Admins and owners can edit projects.

Basic Fields

FieldRequiredNotes
Project NameyesUp to 32 characters
DescriptionnoUp to 500 characters
StatusyesActive or Archived
Next SchedulenoDate and time picker

Test Configuration

The Test Configuration section sets the default Playwright parameters for all tests in this project. Individual run dialogs and config presets can override these values per run.

FieldValuesDefault
Base URLURL string—
BrowserChromium, Firefox, WebKit (Safari)Chromium
ModeHeadless, Headfull, Trace Viewer, DebuggerHeadless
VideoOff, On, Retain on Failure, On First RetryOff
TraceOff, On, Retain on Failure, On First RetryRetain on Failure
ScreenshotOff, On, Only on FailureOnly on Failure
Slow Motion (ms)integer ≥ 00
Repeat Eachinteger 1–101
Test Timeout (ms)integer ≥ 030000
Action Timeout (ms)integer ≥ 00 (no timeout)
Navigation Timeout (ms)integer ≥ 00 (no timeout)
Retriesinteger ≥ 00
Workersinteger ≥ 11
Viewport Widthinteger ≥ 1empty (not set)
Viewport Heightinteger ≥ 1empty (not set)
Track Failed HTTP Requeststoggleoff

When Track Failed HTTP Requests is on, three sub-fields appear:

FieldDescription
Min StatusRecord responses at or above this HTTP status code (e.g. 400). Ignored when Specific Codes is set.
Specific CodesComma-separated status codes to record exactly (e.g. 429, 503). Overrides Min Status.
Ignore URLsComma-separated substrings; responses whose URL contains any of these are skipped.

Click Save Changes to save.

Active Project

The active project is used by the dashboard and applied when running tests from the tests table. Set it at creation time with the Set as active project for current user checkbox. To switch later, use the Select button or Set as Current in the ellipsis menu.

Permissions

Members can view projects. Admins and owners can create, edit, and delete projects. See Roles and Permissions for the full matrix.

Next Steps