# Projects

A project is the topmost organization level. It may represent an application or product that needs to be tested.

# List of projects

All projects are listed on the Projects pane, which is the leftmost pane on the dashboard.

Projects list

Each project list item shows:

Projects list item

  1. the unique ID of the project;
  2. the name of the project and its url;
  3. the name of the team the project belongs to; and
  4. the number of scenarios in the project.

The url is only available is provided when creating the project.

The team name is only available if the project belongs to a team.

The Projects pane may be collapsed when other components need the real estate however, the pane can be expanded again by clicking on the Projects side tab.

Projects tab

# Create a new project

To create a new project, click create at the top right corner of the pane. Then fill out the project information on the shown page.

Create a new project

Before the project can be tested with the runner, <script src="https://cdn.jsdelivr.net/npm/@dscribers/surf-me@1.2.4/dist/surf-me.min.js"></script> needs to be added to the project page.

The latest version of the link would always be provided when the project is being created.

# Project Options

Project options

Click options to the right of each project list item to view the options for the project.

# Edit a project

Click Edit button from the desired project's options and update the project information as desired in the form that is shown to the right.

Edit a project

# Delete a project

Click delete from the desired project's options and confirm deletion.

Confirm project deletion

NOTE: Deleted projects CANNOT be retrieved and this would also delete everything under the project.

# Other Options

  • Copy ID: Copies the id of the project to the clipboard. This may be needed for the cli runner.
  • Export as PDF: Exports the project to a PDF file that's downloaded automatically via your browser.
  • Backup: Creates a zipped backup of the project in the background and sends an email to download the zip file when ready.
  • Insert script: Shows the javascript snippet that needs to be inserted into project pages to make them accessible to [TestSoothe][https://testsoothe.com].

"Export as PDF" and "Backup" options are disabled if project doesn't contain any scenario.

# Import backup

Zip files created with the backup option above can be imported later. Use import to import zip files.

Import project button

An email will be sent once the project has been successfully imported. If there's an error while importing, an email would be sent to indicate this as well.

Note that only zip files containing proper backup files can be uploaded. It is therefore advised to only import zip files created with the backup option.