Skip to main content
Suites are collections of related flows that help you organize your flows and run them together efficiently. Think of suites as folders that group flows by feature, user journey, or any other logical grouping.

​
What is a Suite?

A Suite is a container that groups multiple flows together. Suites provide:
  • Organization: Keep related flows together (e.g., “Login Flows”, “Checkout Flows”)
  • Batch Execution: Run all flows in a suite with one click
  • Shared Authentication: Set up authentication once for all flows in the suite

​
Creating a Suite

​
Step 1: Click “Create Suite”

Navigate to the Flows page and click the folder+ icon or Create Suite button.

​
Step 2: Enter Suite Details

Required:
  • Name: A descriptive name for your suite (e.g., “Authentication Flows”)
Optional:
  • Description: Additional context about what this suite tests
  • Auth Instructions: Shared authentication that runs once before all flows

​
Step 3: Save

Click Create Suite to save. Your new suite appears in the Flows page.

​
Auth Instructions (Setup Flow)

Auth Instructions are special setup instructions that run once at the beginning of the suite, before any flows execute. This is perfect for:
  • Logging in with test credentials
  • Accepting permissions or completing onboarding steps
  • Navigating to a specific section of the app
Example Auth Instructions: 
Login with [email protected] and password TestPass123
Tap "Sign In"
Wait for the home screen to load

​
Benefits of Auth Instructions

  • Write once, use many times: All flows in the suite start from an authenticated state
  • Faster execution: Authentication happens only once, not before every flow
  • Easier maintenance: Update login credentials in one place

​
Adding Flows to a Suite

​
Method 1: Create Flow in Suite

  1. Expand your suite in the Flows page
  2. Click Create Flow inside the suite
  3. Write your flow instructions
  4. The flow is automatically added to the suite

​
Method 2: Add Existing Flows

  1. Expand your suite
  2. Click Add Existing Flows
  3. Check the flows you want to include
  4. Click Add Flows

​
Method 3: Attach from Flow

  1. Click the three dots (⋯) next to any flow
  2. Select Attach to Suite
  3. Check the suites you want to add the flow to
  4. Click Save

​
Managing Suite Contents

​
Reordering Flows

Change the order flows run in:
  1. Expand your suite
  2. Drag and drop flows using the handle icon (⋮⋮)
  3. Release to set the new order
Flows execute in the order they appear in the suite.

​
Removing Flows from Suite

  1. Expand the suite
  2. Click the three dots (⋯) next to the flow
  3. Select Remove from Suite
Removing a flow from a suite doesn’t delete the flow—it just removes the relationship. The flow remains in your Flows list.

​
Running a Suite

​
Running All Flows

  1. Find your suite in the Flows page
  2. Click Run Suite
  3. Select your app
  4. Choose target device (iPhone/iPad for iOS)
  5. Click Run Suite
The suite executes as follows:
  1. Auth Instructions run first (if configured)
  2. Each flow runs, starting from an authenticated state

​
Best Practices

Use Descriptive Suite NamesName suites after features or user journeys: “User Onboarding”, “Payment Processing”, “Profile Management”
Set Up Auth InstructionsIf your flows require authentication, use Auth Instructions instead of repeating login steps in every flow
Keep Suites FocusedGroup related flows together. Don’t create massive suites with unrelated flows—it makes debugging harder.

​
Common Suite Patterns

​
Smoke Flows Suite

A quick suite of critical paths to verify basic functionality:
  • Launch app
  • Login
  • Navigate to main features
  • Logout
Best for: Quick sanity checks after deployments

​
Feature-Specific Suites

Group all flows related to a single feature:
  • “Profile Flows”: Edit profile, upload photo, change password
  • “Checkout Flows”: Add to cart, apply coupon, complete purchase
  • “Settings Flows”: Toggle notifications, change language, logout
Best for: Feature-focused testing

​
Advanced Tips

​
Combining with Automations

Suites are perfect for automation:
  • Set up a daily regression suite
  • Configure a smoke suite to run on every build upload
  • Schedule feature suites weekly
Learn more about Automations →

​
Next Steps

Now that you understand suites: