# rahulnair199131/mobile-automation-framework architecture

> Architecture diagram of the GitHub repository rahulnair199131/mobile-automation-framework, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rahulnair199131/mobile-automation-framework
- Repository: https://github.com/rahulnair199131/mobile-automation-framework

## Overview

This repository is a Java/Appium mobile UI automation framework for running shared Cucumber scenarios against Android and iOS. The principal workflow is scenario selection and execution, per-scenario driver setup, platform-aware page interactions, and failure evidence capture. The graph preserves the documented login and cart/checkout journeys plus configuration, synchronization, and driver management. Some test sources are not excerpted, so their connections are shown only where the README documents them.

Main entry points: [`src/main/java/pages/BasePage.java`](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/BasePage.java) (Page Base), [`src/test/java/stepdefinitions`](https://github.com/rahulnair199131/mobile-automation-framework/tree/main/src/test/java/stepdefinitions) (Step Definitions), [`src/main/java/driver/DriverFactory.java`](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/driver/DriverFactory.java) (Driver Factory), [`src/test/java/hooks/TestHooks.java`](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/test/java/hooks/TestHooks.java) (Scenario Hooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Scenario Execution"]
  node_runner["TestNG Runner<br/>[TestRunner.java]"]
  node_features["BDD Scenarios"]
  node_steps["Step Definitions"]
  node_hooks["Scenario Hooks<br/>[TestHooks.java]"]
end

subgraph group_platform["Platform Runtime"]
  node_config["Runtime Config<br/>[ConfigManager.java]"]
  node_factory["Driver Factory<br/>[DriverFactory.java]"]
  node_manager["Driver Manager<br/>[DriverManager.java]"]
end

subgraph group_pages["Page Objects"]
  node_base["Page Base<br/>[BasePage.java]"]
  node_login["Login Page<br/>[LoginPage.java]"]
  node_home["Home Page<br/>[HomePage.java]"]
  node_checkout["Checkout Page<br/>[CheckoutPage.java]"]
end

subgraph group_targets["Mobile Targets"]
  node_apps["Android / iOS Apps"]
end

node_engineer(("Test Engineer"))
node_appium["Appium Server"]
node_device["Mobile Device"]

node_engineer -->|"starts tests"| node_runner
node_runner -->|"executes scenarios"| node_features
node_features -->|"uses steps"| node_steps
node_hooks -->|"sets up driver"| node_factory
node_hooks -->|"tears down driver"| node_manager
node_steps -->|"drives login"| node_login
node_steps -->|"drives shopping"| node_home
node_steps -->|"drives checkout"| node_checkout
node_factory -->|"reads settings"| node_config
node_factory -->|"creates session"| node_appium
node_factory -->|"loads app"| node_apps
node_appium -.->|"controls device"| node_device
node_base -->|"gets driver"| node_manager
node_base -->|"reads wait"| node_config
node_login -->|"extends"| node_base
node_home -->|"extends"| node_base
node_checkout -->|"extends"| node_base

click node_runner "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/test/java/runners/TestRunner.java"
click node_features "https://github.com/rahulnair199131/mobile-automation-framework/tree/main/src/test/resources/features"
click node_steps "https://github.com/rahulnair199131/mobile-automation-framework/tree/main/src/test/java/stepdefinitions"
click node_hooks "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/test/java/hooks/TestHooks.java"
click node_config "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/config/ConfigManager.java"
click node_factory "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/driver/DriverFactory.java"
click node_manager "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/driver/DriverManager.java"
click node_base "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/BasePage.java"
click node_login "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/LoginPage.java"
click node_home "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/HomePage.java"
click node_checkout "https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/CheckoutPage.java"
click node_apps "https://github.com/rahulnair199131/mobile-automation-framework/tree/main/apps"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_features,node_steps,node_hooks toneBlue
class node_config,node_factory,node_manager toneAmber
class node_base,node_login,node_home,node_checkout,node_appium toneMint
class node_apps toneRose
class node_engineer,node_device toneIndigo
```

## Components

### Scenario Execution

- [TestNG Runner](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/test/java/runners/TestRunner.java): `src/test/java/runners/TestRunner.java`
- [BDD Scenarios](https://github.com/rahulnair199131/mobile-automation-framework/tree/main/src/test/resources/features): `src/test/resources/features`
- [Step Definitions](https://github.com/rahulnair199131/mobile-automation-framework/tree/main/src/test/java/stepdefinitions): `src/test/java/stepdefinitions`
- [Scenario Hooks](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/test/java/hooks/TestHooks.java): `src/test/java/hooks/TestHooks.java`

### Platform Runtime

- [Runtime Config](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/config/ConfigManager.java): `src/main/java/config/ConfigManager.java`
- [Driver Factory](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/driver/DriverFactory.java): `src/main/java/driver/DriverFactory.java`
- [Driver Manager](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/driver/DriverManager.java): `src/main/java/driver/DriverManager.java`

### Page Objects

- [Page Base](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/BasePage.java): `src/main/java/pages/BasePage.java`
- [Login Page](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/LoginPage.java): `src/main/java/pages/LoginPage.java`
- [Home Page](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/HomePage.java): `src/main/java/pages/HomePage.java`
- [Checkout Page](https://github.com/rahulnair199131/mobile-automation-framework/blob/main/src/main/java/pages/CheckoutPage.java): `src/main/java/pages/CheckoutPage.java`

### Mobile Targets

- [Android / iOS Apps](https://github.com/rahulnair199131/mobile-automation-framework/tree/main/apps): `apps`

### Other components

- **Test Engineer**
- **Appium Server**
- **Mobile Device**

## Connections

- Test Engineer → TestNG Runner: starts tests (evidence: `README.md`)
- TestNG Runner → BDD Scenarios: executes scenarios (evidence: `README.md`)
- BDD Scenarios → Step Definitions: uses steps (evidence: `README.md`)
- Scenario Hooks → Driver Factory: sets up driver (evidence: `README.md`)
- Scenario Hooks → Driver Manager: tears down driver (evidence: `README.md`)
- Step Definitions → Login Page: drives login (evidence: `README.md`)
- Step Definitions → Home Page: drives shopping (evidence: `README.md`)
- Step Definitions → Checkout Page: drives checkout (evidence: `README.md`)
- Driver Factory → Runtime Config: reads settings (evidence: `src/main/java/driver/DriverFactory.java`)
- Driver Factory → Appium Server: creates session (evidence: `src/main/java/driver/DriverFactory.java`)
- Driver Factory → Android / iOS Apps: loads app (evidence: `src/main/java/driver/DriverFactory.java`)
- Appium Server → Mobile Device: controls device (evidence: `README.md`)
- Page Base → Driver Manager: gets driver (evidence: `src/main/java/pages/BasePage.java`)
- Page Base → Runtime Config: reads wait (evidence: `src/main/java/pages/BasePage.java`)
- Login Page → Page Base: extends (evidence: `src/main/java/pages/LoginPage.java`)
- Home Page → Page Base: extends (evidence: `src/main/java/pages/HomePage.java`)
- Checkout Page → Page Base: extends (evidence: `src/main/java/pages/CheckoutPage.java`)
