K11TechLab Playwright Automation (TypeScript)

A robust, real-world Playwright automation framework for K11 Software Solutions. This repository demonstrates best practices in TypeScript-based UI automation, accessibility and performance audits, visual regression, DB helpers, and CI-ready reporting.

🚀 Capabilities & Innovations

• Playwright + TypeScript: Tests, fixtures, and helpers implemented in TypeScript. Page objects are under pages/, base classes in webuitestengine/, and helpers in utils/.
• Accessibility audits (axe): Multi-page audits with per-page JSON and an aggregated CSV summary in artifacts/accessibility/.
• Lighthouse automation: Headful Lighthouse runs that output HTML and JSON to artifacts/lighthouse/.
• Visual regression: Snapshot tests and baselines in tests/playwright-advanced/*-snapshots with --update-snapshots support.
• Flaky-test triage demo: Examples showing retries, attachments, and trace/video capture for triage.
• DB & API helpers: Reusable utilities in utils/ for DB access, API testing, and test data setup.
• AI-assisted test generation: Interactive CLI and OpenAI-powered generators (see test-generator-cli/ and ai/) to create Playwright tests programmatically.
• CI / CD: Example GitHub Actions workflows and guidance for running tests, installing browsers, uploading artifacts, and integrating reports in CI pipelines.
• Linting & code quality: ESLint (flat config) with autofix support and TypeScript type checking for consistent code quality (npx eslint, npx tsc --noEmit).
• Advanced reporting: HTML, Ortoni and Allure report generation with artifact upload support for CI.

Project structure

• pages/ — Page objects (TypeScript)
• webuitestengine/ — Base test classes and fixtures
• tests/ — All test suites (functional, visual, accessibility, db, api)
• tests/playwright-advanced/ — Demos: visual, accessibility, flaky handling, Lighthouse
• utils/ — Shared helpers: APIUtil.ts, CommonUtils.ts, DBActions.ts, UIElementActions.ts, WaitUtil.ts
• artifacts/ — Generated artifacts (accessibility, lighthouse, assets)
• report/ — HTML report templates and Ortoni integration
• test-generator-cli/ — AI test generation CLI and templates
• doc/ — Documentation and guides (Lighthouse, accessibility, flaky handling)
• .github/workflows/ — CI workflows (includes run-playwright-tests.yml)

Additional developer artifacts and generators:

• ai/ — OpenAI-based generators and helper scripts (ai/generate-test.ts, JS variants, helpers).
• tests/generated/ — Skeleton tests produced by the interactive CLI generator.
• prompts/ — Optional prompt templates and examples used by generators (local prompt files).

Prerequisites

• Node.js 20+ and npm
• Playwright browsers (installed via npx playwright install --with-deps)
• Optional: Docker for containerized runs

Quickstart

Install dependencies and Playwright browsers:

npm ci
npx playwright install --with-deps

Run the full test suite:

npm test

Run a single test (CI-friendly):

npm run test:single
# or run a specific file
npx playwright test tests/playwright-advanced/visualComparision.test.ts --project=Chrome

Update visual snapshots:

npx playwright test --update-snapshots

Docker (optional)

Build and run the repo in a container (example):

docker build -t k11-playwright .
docker run --rm -e ENV=qa -e NPM_SCRIPT=test:single k11-playwright

CI

The repository includes .github/workflows/run-playwright-tests.yml to run npm ci, install Playwright browsers, run npm run test:single, and upload test-results and artifacts as workflow artifacts.

Artifacts & Reports

• Playwright results and attachments: test-results/
• Framework artifacts: artifacts/ (accessibility, lighthouse, assets)
• HTML and Allure reports: html-report/, allure-report/

Lint & Type-check

• Run ESLint (flat config): npx eslint . --ext .ts,.js
• Auto-fix issues: npx eslint . --fix --ext .ts,.js
• Type-check: npx tsc --noEmit

👩‍💻 Maintainers

K11 Tech QA Team

---

For questions, contributions, or support, please contact the K11 Tech QA team.

License

MIT

🤝 Contribution Guidelines

We welcome contributions to K11TechLab Playwright Automation! To contribute:

1. Fork the repository and create your branch from master.
2. Add clear, descriptive commit messages.
3. Follow the existing folder structure and code style.
4. Add or update documentation for new features or changes.
5. Ensure your code passes all tests and lint checks.
6. Submit a pull request and describe your changes.

Tips:

• For new test cases, add them to the appropriate category in tests/.
• For utilities, use the utils/ folder.
• For documentation, update doc/ or relevant README files.
• For AI features, update ai/ and prompts/ as needed.

Code of Conduct: Please be respectful and constructive in all interactions. We value collaboration and learning.

---

Author

Kavita Jadhav

Accomplished Full Stack Developer and Test Automation Engineer specializing in modern web application development, robust full stack solutions, and scalable automation frameworks. Expert in Playwright, advanced quality engineering, and driving best practices for high-impact, reliable software delivery.

LinkedIn: https://www.linkedin.com/in/kavita-jadhav-tech/

About k11 Software Solutions

k11 Software Solutions is a leading provider of modern, AI-powered test automation, DevOps, and quality engineering services. We help organizations accelerate digital transformation with robust, scalable, and intelligent automation solutions tailored for SaaS, web, and enterprise platforms.

• Website: https://k11softwaresolutions.com
• Contact: k11softwaresolutions@gmail.com

Partner with us to future-proof your QA and automation strategy!

Follow Me