Skip to main content

What is Makers BTG Tests?

Makers BTG Tests is a comprehensive test automation framework built specifically for BTG Pactual applications. It combines industry-leading testing tools and patterns to provide a robust, maintainable, and scalable solution for automated testing. The framework leverages the Screenplay pattern to create readable, reusable test code that models how real users interact with your applications. Whether you’re testing web UIs, APIs, or complex business workflows, this framework provides the structure and tools you need.

Why Use This Framework?

The Makers BTG Tests framework offers several key advantages:

Screenplay Pattern

Write tests from the user’s perspective with clear, maintainable code that focuses on tasks and goals rather than implementation details.

BDD with Cucumber

Define test scenarios in natural language using Gherkin syntax, enabling collaboration between technical and non-technical team members.

Rich Reporting

Get detailed, visual test reports with Serenity BDD that include screenshots, step-by-step execution details, and requirements coverage.

Modern Stack

Built on Java 21 with the latest versions of Serenity BDD, Cucumber, and JUnit 5 for optimal performance and features.

Key Benefits

Maintainability

The Screenplay pattern separates test intentions from implementation, making tests easier to read and maintain. When UI elements change, you only update the implementation in one place.

Scalability

The framework’s modular architecture allows you to easily add new test scenarios, actors, and capabilities as your application grows.

Collaboration

With Cucumber’s Gherkin syntax, business stakeholders can read and validate test scenarios written in Spanish, ensuring tests align with business requirements.

Visibility

Serenity BDD’s living documentation provides instant insight into test coverage, feature status, and requirement fulfillment - all generated automatically from your tests.

Technology Stack

The framework is built on a modern, industry-standard technology stack:
TechnologyVersionPurpose
Java21Core programming language with latest LTS features
Serenity BDD4.0.46Test reporting and living documentation
Cucumber7.14.0BDD framework for Gherkin-based scenarios
JUnit5.10.1Test execution engine
Gradle8.xBuild automation and dependency management
Screenplay Pattern-Design pattern for user-centric test code
AssertJ3.24.2Fluent assertion library

Architecture Overview

The framework follows a clean, layered architecture:
makers-btg-tests/
├── src/test/resources/features/     # Gherkin feature files
├── src/test/java/
│   ├── runners/                     # Test runners
│   ├── stepDefinitions/             # Cucumber step definitions
│   ├── tasks/                       # Screenplay tasks
│   ├── interactions/                # Low-level interactions
│   └── questions/                   # Verifications and assertions
└── target/site/serenity/            # Generated test reports
The framework is configured with the project name “Makers BTG Tests” and uses org.btg.practual as the base package for test organization.

What You’ll Learn

In the following sections, you’ll discover how to:
  • Install and configure the framework on your machine
  • Run your first automated test
  • Write new test scenarios using Gherkin
  • Implement step definitions with the Screenplay pattern
  • Generate and analyze Serenity BDD reports
  • Configure test environments (QA, Staging, Production)

Ready to Get Started?

Follow our quickstart guide to run your first test in minutes

Build docs developers (and LLMs) love