Skip to content

Professional Playwright + TypeScript end-to-end testing portfolio demonstrating CI/CD automation, HTML reporting, and GitHub Actions integration.

Notifications You must be signed in to change notification settings

rmgoede/tekqa-playwright-portfolio

Repository files navigation

🧪 TekQA Playwright Portfolio

Playwright Tests

Automated end-to-end testing portfolio showcasing CI/CD integration, cross-browser execution, and GitHub Actions workflow optimization.


🚀 Project Overview

This repository demonstrates a professional Playwright test automation setup with:

  • ✅ Continuous Integration via GitHub Actions
  • ⚡ Fast CI execution using cached browser binaries
  • 🧭 HTML reports + trace artifacts for debugging failures
  • 🧩 Modular test structure using TypeScript
  • 🔐 Environment-based configuration with .env and .env.example

🧭 What This Portfolio Demonstrates

This project reflects a practical, real-world learning path in modern test automation.
Each test suite demonstrates a different testing technique, similar to what is used on real product teams.

The goal here is clarity, maintainability, and choosing the right tool for the job — not showing off complexity.

Area of Focus Example Test(s) What It Demonstrates Why It Matters
Core UI flow testing saucedemo-login.spec.ts Stable locators + meaningful assertions Foundation of reliable UI automation
Data-driven testing (DDT) saucedemo-cart-ddt.spec.ts Externalized product data → multiple scenarios Avoids duplicated test logic; scales coverage cleanly
Visual regression testing visual-inventory.spec.ts Snapshot versioning & pixel diffs Detects subtle UI regressions with no CSS inspection
API + UI hybrid workflow github-api-ui-hybrid.spec.ts Create test data via API, verify in UI Reduces test flakiness & speeds setup significantly
Page Object Model (POM) polaris-loginflow.spec.ts, polaris-profile-pom.spec.ts Encapsulated locators and actions Keeps tests readable and easier to maintain over time
CI reliability & trace debugging GitHub Actions workflow Trace logs + screenshot artifacts Enables fast root-cause investigation and team collaboration

In short: These tests show how to build automation that is clear to read, stable across UI changes, and practical for ongoing team use.


🎯 Scope & Intent

This project is not intended to be:

  • A full enterprise automation framework
  • A complete regression suite
  • An attempt to showcase “expert-level” Playwright skills

This is intended to demonstrate:

  • A solid and growing foundation in Playwright
  • Understanding of how real software teams structure automated tests
  • Ability to apply patterns like POM, DDT, and hybrid workflows appropriately
  • Comfort running tests in CI, not just locally

I will continue adding to this repository as I expand depth and coverage.
This is a snapshot of where my automation skillset is today, not the finish line.


📂 Repository Structure

📁 .github/workflows/     →  GitHub Actions CI configuration  
🧪 tests/                 →  Core suites (UI, API, POM)  
🧰 scripts/               →  Utility scripts (local-only helpers)  
⚙️ playwright.config.ts   →  Global Playwright settings  
📦 package.json           →  Dependencies & npm scripts  
📘 README.md              →  Documentation & setup guide 
🤖 agents/ai-generated/   →  AI-generated tests and agent plans (in alternate branch)  

⚙️ Setup & Installation

1️⃣ Install dependencies & browsers

npm ci
npx playwright install

🧰 Useful Commands

# Fast local smoke test (quick feedback loop)
npm run test:quick        

# Full suite (all tests across Chromium + Firefox)
npm run test:all           

# Browser-specific execution
npm run test:chromium      
npm run test:ff            

# Debugging / development helpers
npm run test:ui            # Playwright UI test runner
npm run test:headed        # Run tests in visible browser
npm run debug              # PWDEBUG=1 interactive mode

# Results & visual regression
npm run report             # Open the last HTML report
npm run update-snapshots   # Approve new visual baselines

🏁 Status

  • ✅ All current test cases passing in GitHub Actions across Chromium + Firefox
  • 🧪 Framework: Playwright + TypeScript
  • 📦 CI: GitHub Actions with cached browsers & artifacts

🧩 Branch Overview

This repository contains two complementary branches that demonstrate different approaches to QA automation:

🔹 main — Hand-Crafted Automation

  • Traditional Playwright test suite written and maintained manually
  • Demonstrates Page Object Model, DDT, hybrid API/UI tests, and CI reliability
    👉 View main branch »

🔹 chore/agents-saucedemo-gen — AI-Generated Automation

  • Experimental suite created entirely by autonomous QA Agents
  • Includes Planner, Generator, and Healer agents that plan, create, and fix tests automatically
  • Demonstrates how AI can assist human engineers in test authoring and maintenance
    👉 View AI-generated suite »

👨‍💻 Author

Ryan Goede — TekQA Consulting LLC
🌐 TekQAConsulting.com
🔗 LinkedIn


💡 This repository demonstrates both expert-authored and AI-generated automation — showing how craftsmanship and innovation can work together in modern QA engineering.

About

Professional Playwright + TypeScript end-to-end testing portfolio demonstrating CI/CD automation, HTML reporting, and GitHub Actions integration.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published