Maeris logo
Get started for free

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

  • Create a Maeris account or sign in at light.maeris.io
  • Your application URL ready to share with Maeris
  • Test credentials we can use to log into your app

Initial Setup Steps

Step 1: Create Your Maeris Account

Sign up or log in to Maeris. We capture the basics during onboarding so you can start testing right away.

Step 2: Add Your Application URL & Credentials

Provide the base URL for the app you want to test plus login details we can use. This lets Maeris load and validate your experiences.

Step 3: Start in the Notebook

Notebook is the default view once you finish onboarding. This is where you create and manage tests—no extra navigation required.

Create Your First Test from Notebook

From Notebook you can start testing in three ways. Pick what fits best:

Manual (AI-assisted)

Click the “+” icon and describe steps in simple English. AI turns your instructions into runnable steps instantly.

Browser Extension (Recommended)

Record flows and capture selectors as you browse.

View extension setup guide

Terminal

Use natural language in Terminal for fast scripting from the same Notebook view.

Learn how to use Terminal

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

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: