Your First Test Case
This guide walks you through generating BDD scenarios and structured test cases from a real ticket — from zero to a saved test case in under two minutes.
Before you begin
- You have an Active QA Hub account
- You have created at least one Project (the app prompts you on first login)
- You have configured at least one ticket source — see Integrations
Step 1 — Select your connector
In the top bar of the main dashboard, the active connector is displayed. Click it to switch between:
| Connector | When to use |
|---|---|
| Jira | Stories and epics from Jira Cloud |
| Linear | Issues from Linear workspaces |
| Azure DevOps | Work items from ADO boards |
| Manual | Acceptance criteria you write directly in QA Hub |
Your selection is saved per browser. Each team member can use a different connector simultaneously.
Step 2 — Find a ticket
Use the search bar on the Dashboard (/) to locate the story you want to test.
Keyword search
Type a phrase and press Enter. QA Hub queries the active ticket source and returns matching issues.
Load by ID
Enter one or more ticket keys separated by commas:
PROJ-123, PROJ-124, PROJ-125
All tickets are fetched and displayed together — useful when you have a sprint list.
Ask AI
Describe what you're looking for in plain language:
"checkout flow edge cases for guest users"
QA Hub extracts the intent and searches the ticket source automatically.
Step 3 — Generate BDD scenarios
Click on a ticket to expand its acceptance criteria. Then click Generate BDD.
QA Hub sends the ticket title and criteria to your configured AI provider and returns a set of Gherkin scenarios:
Feature: Guest checkout
Scenario: Successful checkout without an account
Given the user has items in the cart
And the user is not logged in
When they proceed to checkout
And complete the payment form as a guest
Then the order is confirmed
And a confirmation email is sent to the provided address
Scenario: Guest checkout with an invalid email
Given the user is on the checkout page
When they enter an invalid email address
And submit the form
Then a validation error is shown
And the order is not placed
You can edit the BDD content directly in the panel before saving.
Step 4 — Generate structured test cases
Below the BDD panel, click Generate Test Cases. QA Hub parses the scenarios and produces structured test cases — each with a title, numbered steps, expected results, and a suggested test layer (UI, API, Unit, or E2E).
Example output:
| Field | Value |
|---|---|
| Title | Guest checkout — successful order confirmation |
| Layer | UI |
| Step 1 | Navigate to the cart with at least one item |
| Step 2 | Click "Proceed to checkout" without logging in |
| Step 3 | Fill in the guest email and payment details |
| Expected | Order confirmation page is displayed; confirmation email is sent |
Step 5 — Save to your library
Click Save Test Cases. Each test case is assigned a unique code (TC-001, TC-002, …) and added to your active project.
You can review them immediately on the Test Cases page.