# vijayan-kr/appium-cucumber-pom architecture

> Architecture diagram of the GitHub repository vijayan-kr/appium-cucumber-pom, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vijayan-kr/appium-cucumber-pom
- Repository: https://github.com/vijayan-kr/appium-cucumber-pom

## Overview

This repository is an Android mobile UI automation example for the Sauce Labs sample app, driven through Appium and a Cucumber runner. The documented workflow is to configure the target device, start Appium, and run the Android runner; the test then exercises product behavior on the app. The tree identifies feature, step-definition, page, hook, and runner components, but their source was not sampled, so internal calls are shown only as unverified dashed links. The only sampled implementation is the properties loader.

Main entry points: [`src/test/java/POM/android/stepDef/ProductStepDef.java`](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/stepDef/ProductStepDef.java) (Product steps), [`src/test/java/POM/android/page/ProductPage.java`](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/page/ProductPage.java) (Product page), [`src/test/java/POM/android/runner/AndroidRunnerClass.java`](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/runner/AndroidRunnerClass.java) (Android runner), [`src/test/java/POM/android/feature/SauceLabProductAndroid.feature`](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/feature/SauceLabProductAndroid.feature) (Product scenario)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Test execution"]
  node_runner["Android runner"]
  node_scenario["Product scenario"]
  node_result["Test outcome"]
end

subgraph group_automation["UI automation"]
  node_steps["Product steps"]
  node_hooks["Test hooks<br/>[Hooks.java]"]
  node_productpage["Product page<br/>[ProductPage.java]"]
  node_basepage["App base page<br/>[AppBasePage.java]"]
end

subgraph group_environment["Test environment"]
  node_loader["Properties loader"]
  node_properties["Device settings"]
  node_appium["Appium server"]
  node_device["Android device"]
  node_sampleapp["Sample mobile app"]
end

node_engineer(("Test engineer"))

node_engineer -->|"runs"| node_runner
node_engineer -->|"configures"| node_properties
node_engineer -->|"starts"| node_appium
node_runner -.->|"executes"| node_scenario
node_scenario -.->|"binds steps"| node_steps
node_steps -.->|"uses"| node_productpage
node_hooks -.->|"configures session"| node_appium
node_productpage -.->|"delegates"| node_basepage
node_loader -.->|"loads"| node_properties
node_steps -.->|"produces"| node_result
node_productpage -.->|"drives"| node_appium
node_appium -->|"controls"| node_device
node_device -->|"runs"| node_sampleapp

click node_runner "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/runner/AndroidRunnerClass.java"
click node_scenario "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/feature/SauceLabProductAndroid.feature"
click node_steps "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/stepDef/ProductStepDef.java"
click node_hooks "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/stepDef/Hooks.java"
click node_productpage "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/page/ProductPage.java"
click node_basepage "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/utils/AppBasePage.java"
click node_loader "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/main/java/utils/PropertiesLoader.java"
click node_properties "https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/main/resources/testdata.properties"

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_scenario,node_result toneBlue
class node_steps,node_hooks,node_productpage,node_basepage toneAmber
class node_loader,node_properties,node_appium,node_device,node_sampleapp toneMint
class node_engineer toneIndigo
```

## Components

### Test execution

- [Android runner](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/runner/AndroidRunnerClass.java): `src/test/java/POM/android/runner/AndroidRunnerClass.java`
- [Product scenario](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/feature/SauceLabProductAndroid.feature): `src/test/java/POM/android/feature/SauceLabProductAndroid.feature`
- **Test outcome**

### UI automation

- [Product steps](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/stepDef/ProductStepDef.java): `src/test/java/POM/android/stepDef/ProductStepDef.java`
- [Test hooks](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/stepDef/Hooks.java): `src/test/java/POM/android/stepDef/Hooks.java`
- [Product page](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/page/ProductPage.java): `src/test/java/POM/android/page/ProductPage.java`
- [App base page](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/test/java/POM/android/utils/AppBasePage.java): `src/test/java/POM/android/utils/AppBasePage.java`

### Test environment

- [Properties loader](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/main/java/utils/PropertiesLoader.java): `src/main/java/utils/PropertiesLoader.java`
- [Device settings](https://github.com/vijayan-kr/appium-cucumber-pom/blob/main/src/main/resources/testdata.properties): `src/main/resources/testdata.properties`
- **Appium server**
- **Android device**
- **Sample mobile app**

### Other components

- **Test engineer**

## Connections

- Test engineer → Android runner: runs (evidence: `README.md`)
- Test engineer → Device settings: configures (evidence: `README.md`)
- Test engineer → Appium server: starts (evidence: `README.md`)
- Android runner → Product scenario: executes
- Product scenario → Product steps: binds steps
- Product steps → Product page: uses
- Test hooks → Appium server: configures session
- Product page → App base page: delegates
- Properties loader → Device settings: loads
- Product steps → Test outcome: produces
- Product page → Appium server: drives
- Appium server → Android device: controls (evidence: `README.md`)
- Android device → Sample mobile app: runs (evidence: `README.md`)
