Skip to main content

Organize stories

In Heal.dev, you can organize stories by

  • projects
  • test suites

Typically, you will run all the stories of a test suite, although it's possible to run only a subset.

Test suite

Slugs

  • Projects are uniquely identified by a slug, eg. projectSlug
  • Suites are uniquely identified by a slug, eg. suiteSlug. The suite slug is unique in each project.
  • Stories are uniquely identified by a story slug eg. storySlug. That slug is unique for each test suite. When the story is updated, the slug stays the same but the story version id is incremented.
  • Blocks use the same conventions as stories.
  • A story can be addressed by its full path projectSlug/suiteSlug/storySlug

Disabling a story

You can toggle a story on or off from the dashboard. Note that, when triggering stories from CI, disabled stories will still be ran when the are explicitly listed by slug.