# baalarazor/automation-bible-playwright architecture

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

- Interactive diagram: https://gitdiagram.com/baalarazor/automation-bible-playwright
- Repository: https://github.com/baalarazor/automation-bible-playwright

## Overview

This repository is a Playwright automation suite for web, mobile-web, API, and learning-lab scenarios. Its user-to-result workflow is to run a configured test project against the practice site or API and observe test outcomes; page objects provide reusable interactions for authentication, forms, navigation, and other practice features. The tree and excerpts support these capabilities, but most test files were not sampled, so their calls into page objects are not shown. Generated reports and bundled Trace Viewer assets are excluded as artifacts rather than the product runtime.

Main entry points: [`playwright.config.js`](https://github.com/baalarazor/automation-bible-playwright/blob/main/playwright.config.js) (Project config), [`src/pages/AuthPage.js`](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/AuthPage.js) (Authentication), [`src/pages/HomePage.js`](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/HomePage.js) (Home page), [`src/pages/PracticeNavPage.js`](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/PracticeNavPage.js) (Practice navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Test execution"]
  node_config["Project config"]
  node_webtests["Web UI tests"]
  node_mobiletests["Mobile UI tests"]
  node_apitests["API tests"]
end

subgraph group_ui["UI page objects"]
  node_home["Home page<br/>[HomePage.js]"]
  node_navigation["Practice navigation<br/>[PracticeNavPage.js]"]
  node_auth["Authentication<br/>[AuthPage.js]"]
  node_forms["Forms<br/>[FormsPage.js]"]
  node_alerts["Alerts<br/>[AlertsPage.js]"]
  node_files["Files<br/>[FilesPage.js]"]
  node_mouse["Mouse interactions<br/>[MousePage.js]"]
  node_base["Base page<br/>[BasePage.js]"]
  node_login["Login page<br/>[LoginPage.js]"]
  node_practicepage["Practice page<br/>[PracticePage.js]"]
end

subgraph group_api["API access"]
  node_client["API client<br/>[ApiClient.js]"]
  node_authapi["Auth API<br/>[AuthApi.js]"]
end

subgraph group_learning["Learning labs"]
  node_basics["Basics lab<br/>[basics.spec.js]"]
  node_locators["Locators lab<br/>[locators.spec.js]"]
  node_assertions["Assertions lab<br/>[assertions.spec.js]"]
  node_network["Network lab<br/>[network.spec.js]"]
  node_traces["Traces lab<br/>[traces.spec.js]"]
end

node_engineer(("Test author"))
node_practice["Practice site"]
node_api_service["Practice API"]
node_credentials["Auth credentials<br/>data"]

node_config -->|"configures project"| node_webtests
node_config -->|"configures project"| node_mobiletests
node_config -->|"configures project"| node_apitests
node_config -->|"configures project"| node_basics
node_home -->|"opens page"| node_practice
node_navigation -->|"navigates pages"| node_practice
node_auth -->|"interacts with page"| node_practice
node_forms -->|"fills and submits"| node_practice
node_mouse -->|"performs actions"| node_practice
node_client -->|"sends requests"| node_api_service
node_auth -->|"loads credentials"| node_credentials

click node_config "https://github.com/baalarazor/automation-bible-playwright/blob/main/playwright.config.js"
click node_webtests "https://github.com/baalarazor/automation-bible-playwright/tree/main/tests/ui/web"
click node_mobiletests "https://github.com/baalarazor/automation-bible-playwright/tree/main/tests/ui/mweb"
click node_apitests "https://github.com/baalarazor/automation-bible-playwright/tree/main/tests/api"
click node_home "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/HomePage.js"
click node_navigation "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/PracticeNavPage.js"
click node_auth "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/AuthPage.js"
click node_forms "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/FormsPage.js"
click node_alerts "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/AlertsPage.js"
click node_files "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/FilesPage.js"
click node_mouse "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/MousePage.js"
click node_base "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/BasePage.js"
click node_login "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/LoginPage.js"
click node_practicepage "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/PracticePage.js"
click node_client "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/api/ApiClient.js"
click node_authapi "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/api/AuthApi.js"
click node_basics "https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/01_basics/basics.spec.js"
click node_locators "https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/02_locators/locators.spec.js"
click node_assertions "https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/03_assertions/assertions.spec.js"
click node_network "https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/04_network/network.spec.js"
click node_traces "https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/05_traces/traces.spec.js"
click node_credentials "https://github.com/baalarazor/automation-bible-playwright/blob/main/src/i18n/auth.credentials.json"

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_config,node_webtests,node_mobiletests,node_apitests toneBlue
class node_home,node_navigation,node_auth,node_forms,node_alerts,node_files,node_mouse,node_base,node_login,node_practicepage toneAmber
class node_client,node_authapi,node_api_service toneMint
class node_basics,node_locators,node_assertions,node_network,node_traces toneRose
class node_engineer,node_practice toneIndigo
class node_credentials toneTeal
```

## Components

### Test execution

- [Project config](https://github.com/baalarazor/automation-bible-playwright/blob/main/playwright.config.js): `playwright.config.js`
- [Web UI tests](https://github.com/baalarazor/automation-bible-playwright/tree/main/tests/ui/web): `tests/ui/web`
- [Mobile UI tests](https://github.com/baalarazor/automation-bible-playwright/tree/main/tests/ui/mweb): `tests/ui/mweb`
- [API tests](https://github.com/baalarazor/automation-bible-playwright/tree/main/tests/api): `tests/api`

### UI page objects

- [Home page](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/HomePage.js): `src/pages/HomePage.js`
- [Practice navigation](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/PracticeNavPage.js): `src/pages/PracticeNavPage.js`
- [Authentication](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/AuthPage.js): `src/pages/AuthPage.js`
- [Forms](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/FormsPage.js): `src/pages/FormsPage.js`
- [Alerts](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/AlertsPage.js): `src/pages/AlertsPage.js`
- [Files](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/FilesPage.js): `src/pages/FilesPage.js`
- [Mouse interactions](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/MousePage.js): `src/pages/MousePage.js`
- [Base page](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/BasePage.js): `src/pages/BasePage.js`
- [Login page](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/LoginPage.js): `src/pages/LoginPage.js`
- [Practice page](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/pages/PracticePage.js): `src/pages/PracticePage.js`

### API access

- [API client](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/api/ApiClient.js): `src/api/ApiClient.js`
- [Auth API](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/api/AuthApi.js): `src/api/AuthApi.js`

### Learning labs

- [Basics lab](https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/01_basics/basics.spec.js): `labs/01_basics/basics.spec.js`
- [Locators lab](https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/02_locators/locators.spec.js): `labs/02_locators/locators.spec.js`
- [Assertions lab](https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/03_assertions/assertions.spec.js): `labs/03_assertions/assertions.spec.js`
- [Network lab](https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/04_network/network.spec.js): `labs/04_network/network.spec.js`
- [Traces lab](https://github.com/baalarazor/automation-bible-playwright/blob/main/labs/05_traces/traces.spec.js): `labs/05_traces/traces.spec.js`

### Other components

- **Test author**
- **Practice site**
- **Practice API**
- [Auth credentials](https://github.com/baalarazor/automation-bible-playwright/blob/main/src/i18n/auth.credentials.json): data · `src/i18n/auth.credentials.json`

## Connections

- Project config → Web UI tests: configures project (evidence: `playwright.config.js`)
- Project config → Mobile UI tests: configures project (evidence: `playwright.config.js`)
- Project config → API tests: configures project (evidence: `playwright.config.js`)
- Project config → Basics lab: configures project (evidence: `playwright.config.js`)
- Home page → Practice site: opens page (evidence: `src/pages/HomePage.js`)
- Practice navigation → Practice site: navigates pages (evidence: `src/pages/PracticeNavPage.js`)
- Authentication → Practice site: interacts with page (evidence: `src/pages/AuthPage.js`)
- Forms → Practice site: fills and submits (evidence: `src/pages/FormsPage.js`)
- Mouse interactions → Practice site: performs actions (evidence: `src/pages/MousePage.js`)
- API client → Practice API: sends requests (evidence: `src/api/ApiClient.js`)
- Authentication → Auth credentials: loads credentials (evidence: `src/pages/AuthPage.js`)
