🚀 Java Selenium BDD Cucumber TestNG HTML-Reporting Maven based Automation Framework

Production-Ready Java Selenium BDD Automation Framework

Build scalable, maintainable, and enterprise-grade UI automation with Java, Selenium, Cucumber, TestNG, and Maven.

⭐ If this project helps you, please consider giving it a Star!

📖 About

This repository provides a production-ready Selenium Automation Framework designed using industry best practices. It helps QA Engineers, Automation Engineers, and Software Developers quickly build reliable UI automation with a clean and scalable architecture.

Whether you're learning Selenium or building enterprise automation, this framework provides an excellent starting point.

Ready To Use Automation Framework - Java, Selenium, Cucumber

YouTube Video Link

https://youtu.be/da-riPsGBtU

✨ Features

☕ Java
🌐 Selenium WebDriver
🥒 BDD using Cucumber
✅ TestNG Integration
📦 Maven Project
📄 HTML Test Reports
🧩 Page Object Model (POM)
🔄 Reusable Components
📊 Data-Driven Testing Ready
🔑 Externalized Configuration
📸 Screenshot Capture on Failure
⚡ Parallel Test Execution Ready [TBD]
📝 Detailed Logging
🚀 CI/CD Friendly
🧹 Easy Maintenance

🏗️ Supported Design Patterns

This framework is built using proven Object-Oriented Design Principles and widely adopted Automation Design Patterns to improve scalability, maintainability, and code reusability.

Design Pattern	Description	Benefits
🔒 Singleton Pattern	Ensures only one instance of WebDriver or shared resources exists during execution.	Efficient resource management, consistent driver lifecycle, reduced memory usage.
🏭 Factory Design Pattern	Centralizes the creation of WebDriver instances and framework components.	Easy browser switching, extensible architecture, cleaner code.
🔗 Fluent / Chain of Responsibility Pattern	Enables readable, chainable method calls for page actions and workflow execution.	Improved readability, expressive test scripts, simplified maintenance.
📊 Data-Driven Pattern	Separates test data from test logic using external data sources such as Excel, CSV, JSON, or Properties files.	Reusable test cases, easier data management, broader test coverage.

💡 Why Design Patterns?

This framework follows industry-standard design patterns to deliver:

✅ Better code reusability
✅ Low maintenance cost
✅ Modular architecture
✅ Cleaner implementation
✅ Enterprise-ready structure
✅ Easy onboarding for new contributors
✅ Scalable automation solution
✅ Improved readability
✅ Faster framework enhancements
✅ Reduced code duplication

🎯 Framework Architecture Highlights

✔ Object-Oriented Programming (OOP)

✔ Singleton Design Pattern

✔ Factory Design Pattern

✔ Fluent Interface Pattern

✔ Chain of Responsibility Pattern

✔ Data-Driven Testing Pattern

✔ Page Object Model (POM)

✔ Reusable Utility Components

✔ Configuration-Driven Execution

✔ Extensible Framework Design

🔥 Top 10 Reasons to Use This Framework

1️⃣ Clean Project Structure

Well-organized folders for easy navigation.

2️⃣ Easy to Learn

Simple architecture suitable for beginners and professionals.

3️⃣ Scalable Design

Add hundreds of test cases without changing the framework.

4️⃣ BDD Ready

Write readable feature files using Gherkin syntax.

5️⃣ Page Object Model

Keeps locators and business logic separated.

6️⃣ Maven Support

Dependency management made simple.

7️⃣ HTML Reports

Beautiful execution reports after every run.

8️⃣ TestNG Integration

Powerful test execution, grouping, prioritization, and parallel execution.

9️⃣ CI/CD Compatible

Works seamlessly with Jenkins, GitHub Actions, Azure DevOps, GitLab CI, Bamboo, and more.

🔟 Open Source & Customizable

Fork it, improve it, and build your own automation solution.

📂 Project Structure

src
 ├── main
 │     ├── pages
 │     ├── utilities
 │     ├── drivers
 │     └── configuration
 │
 └── test
       ├── features
       ├── stepdefinitions
       ├── runners
       ├── hooks
       └── resources

🚀 Getting Started

Clone Repository

git clone https://github.com/imademethink/Automation_Java_Selenium_BDD_Cucumber_TestNG_Reporting_Maven.git

Navigate to Folder

cd Automation_Java_Selenium_BDD_Cucumber_TestNG_Reporting_Maven

Download latest stable chromedriver.exe file

https://googlechromelabs.github.io/chrome-for-testing/

Paste it in below folder
..\Automation_Java_Selenium_BDD_Cucumber_TestNG_Reporting_Maven\src\test\resources\chrome_driver\

Install Dependencies

mvn clean install -DskipTests

Execute Tests

mvn test

Generate Report

HTML reports are automatically generated after execution with failure screenshot attached ..\Automation_Java_Selenium_BDD_Cucumber_TestNG_Reporting_Maven\target\HtmlReport.html

🛠 Technology Stack

Technology	Purpose
Java	Programming Language
Selenium	Browser Automation
Maven	Build Tool
Cucumber	BDD Framework
TestNG	Test Runner
HTML Reports	Execution Reporting
Git	Version Control

📸 Framework Highlights

✔ Reusable Components

✔ Easy Configuration

✔ Cross Browser Support

✔ Parallel Execution Ready

✔ Modular Architecture

✔ Low Maintenance

✔ Production Ready

✔ Enterprise Friendly

📚 Learning Outcomes

This repository demonstrates:

Selenium Best Practices
Page Object Model
BDD Framework Design
TestNG Integration
Automation Framework Architecture
Maven Dependency Management
HTML Reporting
Java Design Principles
Real-world UI Automation

🤝 Contributing

Contributions are welcome!

Feel free to:

⭐ Star the repository
🍴 Fork the project
🐞 Report issues
💡 Suggest improvements
🚀 Submit Pull Requests

📌 Useful Links

Repository

https://github.com/imademethink/Automation_Java_Selenium_BDD_Cucumber_TestNG_Reporting_Maven.git

Pull Requests

https://github.com/imademethink/Automation_Java_Selenium_BDD_Cucumber_TestNG_Reporting_Maven/pulls

💡 Future Roadmap

Selenium Grid
Docker Support
API Automation
Database Validation
Allure Reporting
Extent Reports
Retry Mechanism
Cross Browser Execution
Parallel Execution Optimization [TBD]
GitHub Actions Pipeline

Name		Name	Last commit message	Last commit date
src/test		src/test
README.md		README.md
pom.xml		pom.xml

Latest commit

History

Folders and files

Repository files navigation