Update README.md

Author: sujoy-chandra-das

README.md

@@ -1,110 +1,91 @@
-# 📱 Selenium Java Automation Framework
+# Selenium Java Automation Framework
+
+A compact web test automation framework built with Java, Selenium WebDriver, Maven, and TestNG.
+
+This project demonstrates a practical starter framework for browser-based test automation with reusable setup, externalized configuration, and data-driven execution using Excel.
+
+## What I Built
+
+- Automated website login flow testing with Selenium WebDriver
+- Config-driven browser and URL setup using properties files
+- Externalized UI locators for easier maintenance
+- Data-driven test execution with TestNG and Apache POI
+- Reusable base test class for browser lifecycle management
+- Default TestNG reporting for test execution results
+
+## Tech Stack
+
+- Java
+- Selenium WebDriver
+- TestNG
+- Maven
+- Apache POI
+- WebDriverManager
+
+## Project Structure
+
+```text
+TestAutomationFramework/
+|-- pom.xml
+|-- testrunner/
+|   `-- testng.xml
+|-- src/test/java/
+|   |-- base/
+|   |   `-- BaseTest.java
+|   |-- testcase/
+|   |   `-- MyFirstTestFW.java
+|   `-- utilities/
+|       |-- ReadXLSdata.java
+|       `-- readpropertyFile.java
+`-- src/test/resources/
+    |-- configfiles/
+    |   |-- config.properties
+    |   `-- locators.properties
+    `-- testdata/
+        `-- testdata.xlsx
+```
 
-A **modular web test automation framework** built using **Selenium, Java, Maven, and TestNG**.  
-The framework follows **Page Object Model (POM)** design pattern, enabling **scalable, maintainable, and reusable** automation for Android and iOS apps.  
-It supports **data-driven testing, parallel execution, CI/CD pipelines, and structured reporting**.
+## Framework Highlights
 
----
+### BaseTest
 
-## 📂 Project Structure
+The base layer initializes the browser, loads configuration files, opens the target application, and handles teardown after test execution.
 
-```
+### Data-Driven Testing
 
-AppiumAutomationFramework
-│── pom.xml                         # Maven build configuration & dependencies
-│── src/test/java
-│   ├── base/BaseTest.java           # Driver setup & common hooks
-│   ├── pages/                       # Page Object Model classes for app screens
-│   ├── tests/                       # TestNG test classes
-│   ├── utilities/                   # Reusable helpers (data, waits, config, screenshots)
-│   ├── config/ConfigManager.java    # Loads app & device capabilities from properties file
-│── src/test/resources
-│   ├── testdata/                    # Test data files (Excel/JSON)
-│   ├── capabilities.properties      # Appium server & device config
-│   ├── testng.xml                   # TestNG suite definitions
-│── reports/                         # Test reports (TestNG/Allure/Extent)
-
-````
-
----
-
-## ⚡ Key Features
-
-- **Page Object Model (POM):** Structured page classes for app screens.  
-- **TestNG Integration:** Parallel execution, groups, priorities, and reporting.  
-- **Appium Capabilities Management:** Configurable via `capabilities.properties`.  
-- **Data-Driven Testing:** Support for Excel/JSON/CSV test data.  
-- **Reusable Utilities:**  
-  - Wait strategies (explicit, fluent waits)  
-  - Screenshot capture on failure  
-  - Property/config loader  
-- **Cross-Platform Support:** Android & iOS readiness.  
-- **CI/CD Friendly:** Easily integrated with Jenkins/GitHub Actions.  
-- **Reporting:** TestNG reports with support for Allure/Extent.  
-
----
-
-## 🛠️ Tech Stack
-
-- **Language:** Java  
-- **Mobile Automation:** Appium  
-- **Testing Framework:** TestNG  
-- **Build Tool:** Maven  
-- **Data Handling:** Apache POI (Excel) / JSON  
-- **Device Support:** Android Emulator, Real Devices, iOS Simulator  
-- **CI/CD:** Jenkins / GitHub Actions  
-
----
-
-## ▶️ Getting Started
-
-### Prerequisites
-- Java JDK 8+  
-- Maven 3+  
-- Node.js & Appium Server  
-- Android SDK (for Android) / Xcode (for iOS)  
-- Device or Emulator/Simulator  
-
-### Setup
-```bash
-# Clone repository
-git clone <repo-url>
-cd AppiumAutomationFramework
+Test data is stored in Excel and supplied to TestNG tests through a reusable data provider built with Apache POI.
+
+### Externalized Configuration
+
+Application URL, browser selection, and element locators are separated from test logic through `.properties` files for easier updates.
 
-# Install dependencies
-mvn clean install
-````
+## Run The Tests
 
-### Run Tests
+From the `TestAutomationFramework` folder:
 
 ```bash
-# Run all tests
 mvn test
-
-# Run a specific suite
-mvn test -DsuiteXmlFile=testng.xml
 ```
 
----
-
-## 📊 Reporting
+You can also run the suite from:
 
-* **Default TestNG Reports:** Generated under `/test-output`.
-* **Allure Reports (optional):**
+```text
+TestAutomationFramework/testrunner/testng.xml
+```
 
-  ```bash
-  mvn allure:serve
-  ```
-* **Extent Reports (optional):** For detailed execution logs & screenshots.
+## Configuration Example
 
----
----
+```properties
+browser=firefox
+testurl=https://www.zoho.com/
+```
 
-## 🎯 Highlights for Portfolio
+## Why This Project
 
-* Demonstrates **mobile automation expertise** with Appium & Java.
-* Showcases **reusable automation architecture** with POM & utilities.
-* Ready for **cross-platform execution (Android/iOS)**.
-* Includes **data-driven testing & structured reporting**.
+This project showcases my understanding of:
 
-```
+- Selenium-based web automation
+- Java test framework structuring
+- TestNG data providers and execution flow
+- Maintainable test configuration using external files
+- Building a reusable foundation for future automation scaling