graph TD
    CodePush["Git: Code Push / Pull Request"] --> TriggerCI["GitHub Actions: Trigger Workflow"]
    TriggerCI --> SpinContainer["Spin Up Container: ubuntu-latest"]
    SpinContainer --> CacheCheck{"Cache Hit on Browsers?"}
    CacheCheck -->
Yes
 InstallDeps["Install Node & OS dependencies"]
    CacheCheck -->
No
 InstallPW["Install Node, Browsers, & deps"]
    InstallDeps --> RunTests["Execute: npx playwright test"]
    InstallPW --> RunTests
    RunTests --> SaveReports["Save Artifacts: HTML Reports & Trace Logs"]
    SaveReports --> FinalStatus["Pipeline Complete (Success/Failure)"]

sequenceDiagram
    participant Git as GitHub Repository
    participant Runner as Actions Runner (Host)
    participant Cache as GitHub Cache API
    participant Test as Playwright Runner

    Git->>Runner: Pull Request trigger event
    Runner->>Runner: Checkout codebase code
    Runner->>Cache: Request cached browser binaries
    Cache-->>Runner: Cache restored / missed
    Runner->>Runner: Install npm dependencies
    Note over Runner: Fetch OS libraries if cache missed
    Runner->>Test: Run test suite
    Test-->>Runner: Test execution results
    Runner->>Git: Upload HTML reports (Artifacts)
    Runner->>Git: Update commit status check (Pass/Fail)

name: Playwright Tests
on:
  push:
    branches: [ main, master ]
  pull_request:
    branches: [ main, master ]
jobs:
  test:
    timeout-minutes: 60
    runs-on: ubuntu-latest
    steps:
    # 1. Checkout codebase
uses: actions/checkout@v4

    # 2. Setup Node.js runtime
uses: actions/setup-node@v4
      with:
        node-version: lts/*
        cache: 'npm'

    # 3. Install packages
name: Install dependencies
      run: npm ci

    # 4. Cache Playwright browser binaries
name: Get Playwright Version
      id: playwright-version
      run: echo "version=$(npm ls @playwright/test 
grep @playwright/test
 awk -F@ '{print $3}')" >> $GITHUB_OUTPUT

name: Cache Playwright browsers
      uses: actions/cache@v4
      id: playwright-cache
      with:
        path: ~/.cache/ms-playwright
        key: ${{ runner.os }}-playwright-${{ steps.playwright-version.outputs.version }}

    # 5. Install browser binaries & dependencies
name: Install Playwright Browsers and system dependencies
      if: steps.playwright-cache.outputs.cache-hit != 'true'
      run: npx playwright install --with-deps

name: Install system dependencies only
      if: steps.playwright-cache.outputs.cache-hit == 'true'
      run: npx playwright install-deps

    # 6. Execute automation tests
name: Run Playwright tests
      run: npx playwright test

    # 7. Upload report artifacts on failure
uses: actions/upload-artifact@v4
      if: ${{ !cancelled() }}
      with:
        name: playwright-report
        path: playwright-report/
        retention-days: 30

# Parallel runner configuration summary
jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        shardIndex: [1, 2, 3, 4]
        shardTotal: [4]
    steps:
name: Run Playwright tests
      run: npx playwright test --shard=${{ matrix.shardIndex }}/${{ matrix.shardTotal }}

import { defineConfig } from '@playwright/test';

export default defineConfig({
  // Limit worker count on single container hosts
  workers: process.env.CI ? 1 : undefined,
  // Retry failing tests on CI to check for flakiness
  retries: process.env.CI ? 2 : 0,
  // Configure HTML and blob reporters
  reporter: process.env.CI ? 'blob' : 'html',
  use: {
    // Record traces on retries to save resource sizes
    trace: 'on-first-retry',
    video: 'on-first-retry',
  },
});