# mrpathak20/playwright-automation-framework architecture

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

- Interactive diagram: https://gitdiagram.com/mrpathak20/playwright-automation-framework
- Repository: https://github.com/mrpathak20/playwright-automation-framework

## Overview

This is a Playwright web-automation framework: an engineer selects an environment and runs tests, which exercise application flows through page objects and produce execution artifacts and reports. The graph retains the documented environment-aware data, fixture, smart-utility, assertion, and reporting capabilities, while distinguishing the sampled configuration and reporting calls from capabilities documented but not source-verified. Some branches are therefore connected only where the README states the relationship; unsampled wiring is not inferred.

Main entry points: [`tests`](https://github.com/mrpathak20/playwright-automation-framework/tree/main/tests) (Test Scenarios), [`reporting/email/emailUtil.js`](https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/emailUtil.js) (Email Sender), [`playwright.config.js`](https://github.com/mrpathak20/playwright-automation-framework/blob/main/playwright.config.js) (Playwright Config), [`pages`](https://github.com/mrpathak20/playwright-automation-framework/tree/main/pages) (Page Objects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Execution Setup"]
  node_playwright_config["Playwright Config"]
  node_env_config["Environment Config<br/>[environment.js]"]
  node_execution_config["Execution Settings<br/>[executionConfig.js]"]
  node_env_util["Environment Loader<br/>[environmentUtil.js]"]
  node_dashboard["Execution Dashboard<br/>[dashboardUtil.js]"]
end

subgraph group_automation["Test Automation"]
  node_tests["Test Scenarios"]
  node_fixtures["Playwright Fixtures"]
  node_page_objects["Page Objects"]
  node_pom_refactor["POM Example"]
  node_test_data["Environment Test Data"]
end

subgraph group_support["Execution Support"]
  node_smart_actions["Smart Actions<br/>[clickUtil.js]"]
  node_smart_fill["Smart Fill<br/>[fillUtil.js]"]
  node_retry["Retry Utility<br/>[retryUtil.js]"]
  node_wait["Wait Utility<br/>[waitUtil.js]"]
  node_assertions["Assertions<br/>[assertionUtil.js]"]
  node_soft_assertions["Soft Assertions"]
  node_data_manager["Test Data Manager<br/>[dataManager.js]"]
end

subgraph group_reporting["Reporting"]
  node_allure_env["Allure Environment"]
  node_email_summary["Execution Summary"]
  node_email_template["Email Template<br/>[emailTemplate.js]"]
  node_email_config["Email Settings<br/>[emailConfig.js]"]
  node_email_sender["Email Sender<br/>[emailUtil.js]"]
  node_report_zip["Report Packaging<br/>[zipReport.js]"]
end

node_engineer(("Test Engineer"))
node_external_email(("Email Service"))

node_engineer -->|"starts run"| node_playwright_config
node_playwright_config -->|"loads environment"| node_env_util
node_playwright_config -->|"prints context"| node_dashboard
node_dashboard -->|"reads settings"| node_execution_config
node_playwright_config -->|"runs tests"| node_tests
node_tests -.->|"uses fixtures"| node_fixtures
node_tests -.->|"uses page objects"| node_page_objects
node_tests -.->|"exercises POM example"| node_pom_refactor
node_tests -.->|"uses environment data"| node_test_data
node_env_util -.->|"loads settings"| node_env_config
node_tests -.->|"gets test data"| node_data_manager
node_page_objects -.->|"uses actions"| node_smart_actions
node_page_objects -.->|"uses fill"| node_smart_fill
node_smart_actions -->|"delegates retries"| node_retry
node_smart_fill -->|"delegates retries"| node_retry
node_tests -.->|"waits for readiness"| node_wait
node_tests -.->|"validates results"| node_assertions
node_tests -.->|"uses soft checks"| node_soft_assertions
node_playwright_config -->|"generates on teardown"| node_allure_env
node_email_sender -->|"gets summary"| node_email_summary
node_email_sender -->|"renders message"| node_email_template
node_email_sender -->|"reads settings"| node_email_config
node_email_sender -->|"packages reports"| node_report_zip
node_email_sender -->|"sends report"| node_external_email

click node_playwright_config "https://github.com/mrpathak20/playwright-automation-framework/blob/main/playwright.config.js"
click node_env_config "https://github.com/mrpathak20/playwright-automation-framework/blob/main/config/environment.js"
click node_execution_config "https://github.com/mrpathak20/playwright-automation-framework/blob/main/config/executionConfig.js"
click node_env_util "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/environmentUtil.js"
click node_dashboard "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/dashboardUtil.js"
click node_tests "https://github.com/mrpathak20/playwright-automation-framework/tree/main/tests"
click node_fixtures "https://github.com/mrpathak20/playwright-automation-framework/tree/main/fixtures"
click node_page_objects "https://github.com/mrpathak20/playwright-automation-framework/tree/main/pages"
click node_pom_refactor "https://github.com/mrpathak20/playwright-automation-framework/tree/main/Playwright_POM_Refactor/pages"
click node_test_data "https://github.com/mrpathak20/playwright-automation-framework/tree/main/test-data"
click node_smart_actions "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/clickUtil.js"
click node_smart_fill "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/fillUtil.js"
click node_retry "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/retryUtil.js"
click node_wait "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/waitUtil.js"
click node_assertions "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/assertionUtil.js"
click node_soft_assertions "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/softAssertionUtil.js"
click node_data_manager "https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/dataManager.js"
click node_allure_env "https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/allure/environmentWriter.js"
click node_email_summary "https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/executionSummary.js"
click node_email_template "https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/emailTemplate.js"
click node_email_config "https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/emailConfig.js"
click node_email_sender "https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/emailUtil.js"
click node_report_zip "https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/zip/zipReport.js"

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_playwright_config,node_env_config,node_execution_config,node_env_util,node_dashboard toneBlue
class node_tests,node_fixtures,node_page_objects,node_pom_refactor,node_test_data toneAmber
class node_smart_actions,node_smart_fill,node_retry,node_wait,node_assertions,node_soft_assertions,node_data_manager toneMint
class node_allure_env,node_email_summary,node_email_template,node_email_config,node_email_sender,node_report_zip toneRose
class node_engineer,node_external_email toneIndigo
```

## Components

### Execution Setup

- [Playwright Config](https://github.com/mrpathak20/playwright-automation-framework/blob/main/playwright.config.js): `playwright.config.js`
- [Environment Config](https://github.com/mrpathak20/playwright-automation-framework/blob/main/config/environment.js): `config/environment.js`
- [Execution Settings](https://github.com/mrpathak20/playwright-automation-framework/blob/main/config/executionConfig.js): `config/executionConfig.js`
- [Environment Loader](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/environmentUtil.js): `utils/environmentUtil.js`
- [Execution Dashboard](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/dashboardUtil.js): `utils/dashboardUtil.js`

### Test Automation

- [Test Scenarios](https://github.com/mrpathak20/playwright-automation-framework/tree/main/tests): `tests`
- [Playwright Fixtures](https://github.com/mrpathak20/playwright-automation-framework/tree/main/fixtures): `fixtures`
- [Page Objects](https://github.com/mrpathak20/playwright-automation-framework/tree/main/pages): `pages`
- [POM Example](https://github.com/mrpathak20/playwright-automation-framework/tree/main/Playwright_POM_Refactor/pages): `Playwright_POM_Refactor/pages`
- [Environment Test Data](https://github.com/mrpathak20/playwright-automation-framework/tree/main/test-data): `test-data`

### Execution Support

- [Smart Actions](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/clickUtil.js): `utils/clickUtil.js`
- [Smart Fill](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/fillUtil.js): `utils/fillUtil.js`
- [Retry Utility](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/retryUtil.js): `utils/retryUtil.js`
- [Wait Utility](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/waitUtil.js): `utils/waitUtil.js`
- [Assertions](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/assertionUtil.js): `utils/assertionUtil.js`
- [Soft Assertions](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/softAssertionUtil.js): `utils/softAssertionUtil.js`
- [Test Data Manager](https://github.com/mrpathak20/playwright-automation-framework/blob/main/utils/dataManager.js): `utils/dataManager.js`

### Reporting

- [Allure Environment](https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/allure/environmentWriter.js): `reporting/allure/environmentWriter.js`
- [Execution Summary](https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/executionSummary.js): `reporting/email/executionSummary.js`
- [Email Template](https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/emailTemplate.js): `reporting/email/emailTemplate.js`
- [Email Settings](https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/emailConfig.js): `reporting/email/emailConfig.js`
- [Email Sender](https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/email/emailUtil.js): `reporting/email/emailUtil.js`
- [Report Packaging](https://github.com/mrpathak20/playwright-automation-framework/blob/main/reporting/zip/zipReport.js): `reporting/zip/zipReport.js`

### Other components

- **Test Engineer**
- **Email Service**

## Connections

- Test Engineer → Playwright Config: starts run (evidence: `README.md`)
- Playwright Config → Environment Loader: loads environment (evidence: `playwright.config.js`)
- Playwright Config → Execution Dashboard: prints context (evidence: `playwright.config.js`)
- Execution Dashboard → Execution Settings: reads settings (evidence: `utils/dashboardUtil.js`)
- Playwright Config → Test Scenarios: runs tests (evidence: `playwright.config.js`)
- Test Scenarios → Playwright Fixtures: uses fixtures (evidence: `README.md`)
- Test Scenarios → Page Objects: uses page objects (evidence: `README.md`)
- Test Scenarios → POM Example: exercises POM example
- Test Scenarios → Environment Test Data: uses environment data (evidence: `README.md`)
- Environment Loader → Environment Config: loads settings
- Test Scenarios → Test Data Manager: gets test data
- Page Objects → Smart Actions: uses actions
- Page Objects → Smart Fill: uses fill
- Smart Actions → Retry Utility: delegates retries (evidence: `utils/clickUtil.js`)
- Smart Fill → Retry Utility: delegates retries (evidence: `utils/fillUtil.js`)
- Test Scenarios → Wait Utility: waits for readiness (evidence: `README.md`)
- Test Scenarios → Assertions: validates results (evidence: `README.md`)
- Test Scenarios → Soft Assertions: uses soft checks (evidence: `README.md`)
- Playwright Config → Allure Environment: generates on teardown
- Email Sender → Execution Summary: gets summary (evidence: `reporting/email/emailUtil.js`)
- Email Sender → Email Template: renders message (evidence: `reporting/email/emailUtil.js`)
- Email Sender → Email Settings: reads settings (evidence: `reporting/email/emailUtil.js`)
- Email Sender → Report Packaging: packages reports (evidence: `reporting/email/emailUtil.js`)
- Email Sender → Email Service: sends report (evidence: `reporting/email/emailUtil.js`)
