Quick Start

A full tutorial in several steps to get you started with Neodymium.

This tutorial will guide you through writing browser-based test automation with Neodymium from scratch.

By following these steps, you will learn how to:

  • Set up Neodymium in your project.
  • Write and execute your first test.
  • Use the Page Object Model for better code structure.
  • Implement data-driven testing.
  • Localize your tests for different regions.
  • Configure tests for multiple browsers.
  • Add accessibility checks with Lighthouse.

Adding Neodymium

To add Neodymium to your project, include the following dependency in your pom.xml:

<dependencies>
    <dependency>
        <groupId>com.xceptance</groupId>
        <artifactId>neodymium-library</artifactId>
        <version>5.2.0</version>
    </dependency>
</dependencies>

Once this dependency is included, you can begin writing Neodymium tests.

Check out the First Test page to get started!


First Test

Write and run your first browser-based test with Neodymium.

Reporting

Generate detailed test execution reports with Allure.

Page Objects

Improve code readability and maintainability with the Page Object Model.

Data Driven

Separate test logic from test data using multiple formats.

Localization

Reuse test code across multiple locales and websites.

Multibrowser

Configure and run tests across multiple browsers and devices.

Configuration

Overview of key configuration files and properties in Neodymium.

Accessibility

Integrate Google Lighthouse for accessibility and performance testing.

Last modified December 14, 2025: Split quick start (fed819c3)