Skip to main content

Write & Run a Spec

Now the tutorial will demonstrate writing and executing a Spec, using Testspace's Manual tab. No repo or local files are needed — everything happens in-app, in the project and space created in Setup.

Write a Spec​

Click on the main space, select the Manual tab, then click New Spec.

A spec requires front matter identifying it as a Testspace spec, a spec Name (an <H1>), and at least one Case (an <H2>). Enter the following in the editor:

---
testspace:
---

# Hello Manual
This is a manual test.

## Test Case One
Some description here.

* check this
* check that

## Test Case Two
Some description here.

* check this
* check that

Click Preview to see exactly what a tester will see, then save.

tip

Specs support markdown syntax — lists, tables, images, links — plus Liquid for variables, includes, and conditional logic. See Writing a Spec for the full syntax.

Execute​

Click on Hello Manual to open it:

  • Select the START button to begin execution
  • Select Passed for the status of Test Case One
  • Select Passed for the status of Test Case Two
  • Add optional comments or images
  • When done select the STOP button

Close the spec dialog.

Status​

Testspace provides multiple ways to view a spec's status.

Listing​

The Overall listing on the Manual tab reflects the latest status of all of the test specs that have been executed.

Results​

The Current tab represents the most recent published Results for all tests, which can include published results.

Recap​

This section covered writing and running a spec:

  • Specs are written and saved directly in Testspace — no files, no commits
  • Specs are executed as individual units
  • The status of specs is maintained within the Manual tab, and alongside published automated results within the Results tab