Getting StartedRun First Test

Run Your First Test

Let’s create and run your first test! We’ll keep it simple to help you understand how BugBrain works.

Quick Test: Homepage Load

We’ll create a simple test that checks if your website’s homepage loads successfully.

1
Go to Test Cases
From your project page, click on 'Test Cases' in the sidebar.
2
Click 'New Test Case'
Click the 'New Test Case' button to open the test case creator.
3
Enter Test Details
Give your test a name like 'Homepage Loads' and add a description like 'Verify the homepage loads without errors'.
4
Add Test Steps
Click 'Add Step' and create one step: Action: 'Navigate', Target: your homepage URL, Expected: 'Page loads successfully'.
5
Save the Test
Click 'Save Test Case' to save your first test.
6
Run the Test
Click the 'Run Test' button to execute it. BugBrain will open a browser and perform the test.
7
View Results
Wait for the test to complete (usually 10-30 seconds). You'll see the results showing pass/fail status, screenshots, and execution details.

Understanding Test Results

After your test runs, you’ll see:

  • Status - Pass (green) or Fail (red)
  • Duration - How long the test took
  • Screenshots - Visual proof of each step
  • Logs - Detailed execution information
  • Error Details - If failed, why it failed

Success! If your test passed, congratulations! You’ve just run your first automated test with BugBrain.

What If My Test Failed?

Don’t worry! Failed tests are normal. Common reasons:

  1. Wrong URL - Make sure the URL is correct and accessible
  2. Slow Loading - The page might be loading slowly (increase timeout)
  3. Network Issues - Check your internet connection
  4. Authentication Required - The page might need login (use Personas)

Next Steps: Go Further

Now that you’ve run your first test, try:

1. Create More Complex Tests

Add multiple steps to test a complete user journey:

  • Navigate to login page
  • Enter credentials
  • Click submit
  • Verify dashboard appears

Learn how to create tests manually →

2. Use AI to Generate Tests

Instead of creating tests manually, let AI do it for you!

Learn how to generate tests with AI →

3. Discover Your Application

Let BugBrain automatically explore your site and find all pages and flows.

Learn about Discovery →

4. Set Up Notifications

Get notified in Slack or Jira when tests fail.

Learn about Integrations →

Pro Tips

💡

Tip 1: Use descriptive test names like “User can login with valid credentials” instead of “Test 1”

Tip 2: Add assertions to verify specific elements appear on the page

Tip 3: Take advantage of AI test generation for comprehensive coverage

Tip 4: Set up test plans to run multiple tests together

Need Help?

  • Check out Test Execution to learn more about running tests
  • Read the Test Cases guide to understand test structure
  • Use the AI Chat Assistant in the app for instant help
Create Project