# akshayp7/playwright-typescript-playwright-test architecture

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

- Interactive diagram: https://gitdiagram.com/akshayp7/playwright-typescript-playwright-test
- Repository: https://github.com/akshayp7/playwright-typescript-playwright-test

## Overview

This repository is a Playwright/TypeScript end-to-end testing framework. Its main workflow is an engineer selecting an environment and test run, then Playwright executing browser tests against an application and producing test results. The project also covers API, database, accessibility, device, visual-comparison, Lighthouse, and PDF-text testing. Sampled code shows fixture setup, page objects, and shared browser/API/database helpers; several test implementations and integrations are documented but were not sampled, so those links are omitted or marked unverified.

Main entry points: [`lib/WebActions.ts`](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/WebActions.ts) (Browser helpers), [`lib/BaseTest.ts`](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/BaseTest.ts) (Test fixtures), [`playwright.config.ts`](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/playwright.config.ts) (Run configuration), [`pageFactory/pageRepository`](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/pageFactory/pageRepository) (Page objects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Test execution"]
  node_configuration["Run configuration"]
  node_environment["Environment settings<br/>[testConfig.ts]"]
end

subgraph group_browser["Browser testing"]
  node_browser_suite["Browser test suite"]
  node_fixtures["Test fixtures<br/>[BaseTest.ts]"]
  node_page_objects["Page objects"]
  node_browser_helpers["Browser helpers<br/>[WebActions.ts]"]
end

subgraph group_integrations["Specialized testing"]
  node_api_suite["API tests"]
  node_api_helpers["API helpers<br/>[APIActions.ts]"]
  node_db_suite["Database tests"]
  node_db_helpers["Database helpers<br/>[DBActions.ts]"]
  node_accessibility["Accessibility tests"]
  node_device_tests["Device emulation"]
  node_visual_tests["Visual comparison"]
  node_lighthouse["Lighthouse audits"]
  node_pdf_tests["PDF text tests<br/>[PdfToText.test.ts]"]
end

subgraph group_results["Test outputs"]
  node_reporting["Test reporting"]
end

node_engineer(("Engineer"))
node_playwright["Playwright runner"]

node_engineer -->|"starts tests"| node_playwright
node_playwright -->|"loads config"| node_configuration
node_configuration -->|"reads settings"| node_environment
node_playwright -->|"runs tests"| node_browser_suite
node_fixtures -->|"creates fixtures"| node_page_objects
node_fixtures -->|"creates helper"| node_browser_helpers
node_page_objects -->|"uses actions"| node_browser_helpers
node_playwright -->|"runs tests"| node_api_suite
node_playwright -->|"runs tests"| node_db_suite
node_playwright -->|"runs tests"| node_accessibility
node_playwright -->|"runs tests"| node_device_tests
node_playwright -->|"runs tests"| node_visual_tests
node_engineer -->|"runs audit"| node_lighthouse
node_browser_helpers -.->|"extracts PDF text"| node_pdf_tests
node_playwright -->|"emits reports"| node_reporting

click node_configuration "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/playwright.config.ts"
click node_environment "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/testConfig.ts"
click node_browser_suite "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/functional"
click node_fixtures "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/BaseTest.ts"
click node_page_objects "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/pageFactory/pageRepository"
click node_browser_helpers "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/WebActions.ts"
click node_api_suite "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/api"
click node_api_helpers "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/APIActions.ts"
click node_db_suite "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/db"
click node_db_helpers "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/DBActions.ts"
click node_accessibility "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/accessibility"
click node_device_tests "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/devices"
click node_visual_tests "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/visualComparison"
click node_lighthouse "https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/lighthouse"
click node_pdf_tests "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/tests/functional/PdfToText.test.ts"
click node_reporting "https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/CustomReporterConfig.ts"

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_configuration,node_environment toneBlue
class node_browser_suite,node_fixtures,node_page_objects,node_browser_helpers toneAmber
class node_api_suite,node_api_helpers,node_db_suite,node_db_helpers,node_accessibility,node_device_tests,node_visual_tests,node_lighthouse,node_pdf_tests toneMint
class node_reporting toneRose
class node_engineer,node_playwright toneIndigo
```

## Components

### Test execution

- [Run configuration](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/playwright.config.ts): `playwright.config.ts`
- [Environment settings](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/testConfig.ts): `testConfig.ts`

### Browser testing

- [Browser test suite](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/functional): `tests/functional`
- [Test fixtures](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/BaseTest.ts): `lib/BaseTest.ts`
- [Page objects](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/pageFactory/pageRepository): `pageFactory/pageRepository`
- [Browser helpers](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/WebActions.ts): `lib/WebActions.ts`

### Specialized testing

- [API tests](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/api): `tests/api`
- [API helpers](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/APIActions.ts): `lib/APIActions.ts`
- [Database tests](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/db): `tests/db`
- [Database helpers](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/lib/DBActions.ts): `lib/DBActions.ts`
- [Accessibility tests](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/accessibility): `tests/accessibility`
- [Device emulation](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/devices): `tests/devices`
- [Visual comparison](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/visualComparison): `tests/visualComparison`
- [Lighthouse audits](https://github.com/akshayp7/playwright-typescript-playwright-test/tree/main/tests/lighthouse): `tests/lighthouse`
- [PDF text tests](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/tests/functional/PdfToText.test.ts): `tests/functional/PdfToText.test.ts`

### Test outputs

- [Test reporting](https://github.com/akshayp7/playwright-typescript-playwright-test/blob/main/CustomReporterConfig.ts): `CustomReporterConfig.ts`

### Other components

- **Engineer**
- **Playwright runner**

## Connections

- Engineer → Playwright runner: starts tests (evidence: `README.md`)
- Playwright runner → Run configuration: loads config (evidence: `playwright.config.ts`)
- Run configuration → Environment settings: reads settings (evidence: `playwright.config.ts`)
- Playwright runner → Browser test suite: runs tests (evidence: `README.md`)
- Test fixtures → Page objects: creates fixtures (evidence: `lib/BaseTest.ts`)
- Test fixtures → Browser helpers: creates helper (evidence: `lib/BaseTest.ts`)
- Page objects → Browser helpers: uses actions (evidence: `pageFactory/pageRepository/LoginPage.ts`)
- Playwright runner → API tests: runs tests (evidence: `README.md`)
- Playwright runner → Database tests: runs tests (evidence: `README.md`)
- Playwright runner → Accessibility tests: runs tests (evidence: `README.md`)
- Playwright runner → Device emulation: runs tests (evidence: `README.md`)
- Playwright runner → Visual comparison: runs tests (evidence: `README.md`)
- Engineer → Lighthouse audits: runs audit (evidence: `README.md`)
- Browser helpers → PDF text tests: extracts PDF text
- Playwright runner → Test reporting: emits reports
