Central Playwright E2E

The Playwright suite for the Central Application lives in the Frontend repository:

• Guide: SaaS-Frontend/docs/testing/PLAYWRIGHT.md
• Tests: SaaS-Frontend/e2e/tests/<module>/
• Shared POM / fixtures: SaaS-Frontend/e2e/{pages,fixtures,helpers,utils,test-data}/
• Config: SaaS-Frontend/playwright.config.ts

Scope

Covers Platform/Core only: auth, dashboard, tenants (workspaces), users, roles, permissions matrix, modules, marketplace, billing (Billing nav + payment gateways + settings billing tab + tenant invoice/payment tabs), impersonation, settings, profile, smoke, and regression.

Does not cover Stripe Checkout or future ERP modules beyond what is listed below. Tenant Settings branding/mail coverage lives in e2e/tests/settings/tenant-settings.spec.ts. Tenant Users/Roles RBAC coverage lives in e2e/tests/users/tenant-users.spec.ts (npm run test:e2e:tenant-rbac). Leads product UI: e2e/tests/leads/ (npm run test:e2e:leads). Tasks product UI: e2e/tests/tasks/ (npm run test:e2e:tasks). Communication Templates: e2e/tests/communication-templates/ (npm run test:e2e:communication-templates). Tenant suites use Playwright project tenant.

Spec directories (independently runnable)

Suite	Path	npm script
Auth	e2e/tests/auth/	npm run test:e2e:auth
Dashboard	e2e/tests/dashboard/	npm run test:e2e:dashboard
Tenants / workspaces	e2e/tests/tenants/	npm run test:e2e:tenants
Users	e2e/tests/users/	npm run test:e2e:users (Central) · npm run test:e2e:tenant-rbac (workspace Users/Roles)
Roles	e2e/tests/roles/	npm run test:e2e:roles
Permissions	e2e/tests/permissions/	npm run test:e2e:permissions
Modules	e2e/tests/modules/	npm run test:e2e:modules
Marketplace	e2e/tests/marketplace/	npm run test:e2e:marketplace
Billing	e2e/tests/billing/	npm run test:e2e:billing
Impersonation	e2e/tests/impersonation/	npm run test:e2e:impersonation
Settings	e2e/tests/settings/	npm run test:e2e:settings — Central identity/flags + tenant-settings.spec.ts workspace branding/mail fallback (npm run test:e2e:tenant-settings)
Leads	e2e/tests/leads/	npm run test:e2e:leads
Tasks	e2e/tests/tasks/	npm run test:e2e:tasks
Communication Templates	e2e/tests/communication-templates/	npm run test:e2e:communication-templates
Profile	e2e/tests/profile/	npm run test:e2e:profile
Smoke	e2e/tests/smoke/	npm run test:e2e:smoke
Regression	e2e/tests/regression/	npm run test:e2e:regression

Setup project (auth.setup.ts) authenticates once for chromium suites. Auth and tenant projects use empty storage and do not depend on setup.

QA status (Central stabilization)

• Full suite: 48 passed, 0 skipped, 0 failed (local Chromium run).
• Each module directory is executable independently via npx playwright test e2e/tests/<module> or the npm scripts above.
• After module-level green runs, re-run npm run test:e2e before declaring Central stable.

Screenshots

Playwright writes generated screenshots under:

SaaS-Frontend/docs/testing/images/
SaaS-Frontend/test-results/
SaaS-Frontend/playwright-report/

Those paths are gitignored in Frontend and Backend — never commit e2e-generated images, videos, or traces there.

Curated documentation screenshots may be committed only in this Docs repo (testing/images/…) when intentionally documenting a workflow. Do not dump raw Playwright run output into Docs.

Quick start

cd SaaS-Frontend
cp .env.e2e.example .env.e2e
npm install
npx playwright install chromium
npm run test:e2e
npm run test:e2e:report

See the Frontend guide for environment variables, CI usage, debugging, and extension patterns.