FeaturesDiscovery

Discovery

Discovery automatically crawls your web application to find pages, detect user flows, identify UI patterns, and generate documentation.

What is Discovery?

Think of Discovery as an intelligent spider that explores your website:

  • Finds all pages by following links
  • Detects user flows (login, signup, checkout, etc.)
  • Identifies UI patterns (forms, tables, modals, navigation)
  • Captures screenshots of every page
  • Generates documentation about your app structure

Why Use Discovery?

For New Applications

  • Quickly understand the app structure
  • Find all user journeys
  • Identify areas that need testing

For Existing Applications

  • Detect changes between versions
  • Find pages you didn’t know existed
  • Verify all flows still work

For Regression Testing

  • Compare before and after deployments
  • Detect UI changes automatically
  • Ensure no pages are broken

How Discovery Works

1
You Configure
Set the starting URL, max depth to crawl, and any URL patterns to include or exclude.
2
BugBrain Crawls
A browser automatically navigates through your site, following links and discovering pages.
3
Flows Detected
AI analyzes the crawl to identify common user flows like authentication, CRUD operations, and checkout.
4
You Review Results
View discovered pages, flows, patterns, and screenshots. Generate tests or documentation from the results.

Discovery Configuration

When starting a discovery session:

SettingDescriptionExample
Base URLStarting point for the crawlhttps://example.com
Max DepthHow many levels deep to explore3 (homepage → category → product)
Max PagesMaximum pages to discover100
Include PatternsURLs to include/products/, /blog/
Exclude PatternsURLs to skip/admin/, /api/
Screenshot CaptureTake screenshots of pagesEnabled

Recommended Settings: Start with Max Depth: 3 and Max Pages: 50 for your first discovery. You can increase these for more comprehensive crawls.

Authenticated Discovery

Test authenticated areas using Personas:

  1. Select a Persona with login credentials
  2. Discovery logs in automatically
  3. Crawls protected pages behind authentication
  4. Discovers user-specific flows

Learn about Personas →

What Discovery Finds

Pages

Every page discovered includes:

  • URL and title
  • HTTP status code
  • Screenshot
  • Page elements (links, forms, buttons)
  • Load time

User Flows

Automatically detected flows:

  • Authentication - Login, signup, password reset
  • CRUD Operations - Create, read, update, delete
  • Search - Search forms and results
  • Navigation - Site navigation patterns
  • Checkout - E-commerce purchase flows
  • Onboarding - New user orientation

UI Patterns

Identified patterns:

  • Forms - Input fields, selectors, submissions
  • Tables - Data grids and lists
  • Modals - Dialogs and popups
  • Navigation - Menus, breadcrumbs, footers
  • Cards - Content cards and tiles

Crawl Comparison

Compare two discovery sessions to detect changes:

Before Deployment → After Deployment

    Comparison Report:
    - New pages: 5
    - Removed pages: 2
    - Modified pages: 12
    - Changed flows: 1

Change Severity

Changes are categorized:

  • Critical - Broken pages, missing flows
  • Major - Significant UI changes, new errors
  • Minor - Small content or style changes
⚠️

CI/CD Integration: Run discovery before and after deployment to catch regressions automatically.

Generating From Discovery Results

1. Generate Test Cases

Automatically create tests from discovered flows:

  • Each flow becomes a test case
  • Steps are based on the actual journey
  • Assertions verify key elements

2. Generate Documentation

AI analyzes results to create:

  • Application structure overview
  • Flow documentation
  • UI pattern inventory
  • API endpoint list

3. Export Data

Export discovery results:

  • JSON - Machine-readable data
  • CSV - Page list spreadsheet
  • PDF - Visual report with screenshots

Controlling Discovery

Pause/Resume

Pause a running discovery and resume later:

  • Useful for long crawls
  • Saves progress
  • Resume from where it stopped

Cancel

Stop a discovery and discard remaining work:

  • Keeps what’s been discovered so far
  • Useful if discovering unwanted areas

Discovery Limits

Discovery counts against your plan quota:

PlanMonthly Discovery Sessions
Starter10 sessions
Growth50 sessions
ProUnlimited
💡

Quota Usage: Each discovery session counts as one, regardless of how many pages are discovered.

Best Practices

  1. Start Small - Begin with limited depth and pages
  2. Use Exclusions - Skip admin areas, APIs, and external links
  3. Schedule Regular Crawls - Weekly or before deployments
  4. Compare Baselines - Keep a baseline crawl to compare against
  5. Generate Tests - Don’t just discover - create tests from results!

Next Steps