Maeris logo
Sign In

Quick Setup

Get your Maeris UI testing environment up and running quickly. This guide will walk you through the essential setup steps to start testing your application.

Prerequisites

  • A Maeris account (sign up at light.maeris.io)
  • Access to the application you want to test
  • A modern web browser (Chrome, Firefox, Edge, or Safari)
  • Basic understanding of your application's structure

Initial Setup Steps

Step 1: Access Your Notebook

After logging into Maeris, navigate to the Notebook section. This is your central workspace for managing all your UI tests.

Navigation: Dashboard → Notebook

Step 2: Configure Your Application URL

Set up the base URL of the application you want to test. This will be used as the starting point for all your test cases.

  1. Go to Platform Settings
  2. Enter your application's base URL
  3. Save the configuration

Step 3: Install Browser Extension (Optional but Recommended)

The Light QA Extension helps you record test flows and fetch selectors easily. While not required, it significantly speeds up test creation.

Learn more: Installing the Light QA Extension

Step 4: Verify Your Setup

Test your configuration by creating a simple test case that navigates to your application's homepage.

This will confirm that Maeris can access and interact with your application.

Configuration Options

Browser Settings

  • Select your preferred browser for test execution
  • Configure browser options (headless mode, window size, etc.)
  • Set up browser-specific capabilities if needed

Environment Variables

  • Set up environment-specific variables (dev, staging, production)
  • Configure API keys and authentication tokens
  • Define custom variables for your test scenarios

Timeout Settings

  • Configure default timeouts for element interactions
  • Set page load timeouts
  • Adjust wait times for asynchronous operations

Common Setup Issues

Connection Issues

If Maeris cannot connect to your application:

  • Verify the application URL is correct and accessible
  • Check for firewall or network restrictions
  • Ensure the application is running and accessible from the internet

Authentication Problems

If you're having trouble with authentication:

  • Configure authentication credentials in Platform Settings
  • Set up session management if needed
  • Use API hooks for authentication flows

Selector Issues

If elements cannot be found:

  • Use the Light QA Extension to fetch accurate selectors
  • Verify element selectors are correct and unique
  • Check if elements are loaded before interaction

Next Steps

Once your setup is complete, you're ready to start creating tests: