skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
handbook.adra.dev61 installs

playwright-e2e-adra

Write and debug Playwright E2E tests in the ADRA adra-frontends monorepo (Nuxt + @adra-network/testing-utilities). Use whenever adding, fixing, or reviewing tests/e2e/*.test.ts, configuring test:e2e, debugging flakes, choosing serial vs parallel execution, auth setup, data-testid selectors, or running nx test:e2e — even if the user only says "e2e test", "playwright flake", or "office-manager test fails".

How do I install this agent skill?

npx skills add https://handbook.adra.dev --skill playwright-e2e-adra
view source ↗

Is this agent skill safe to install?

No partner audit is available yet. Read the source before installing.

What does this agent skill do?

Playwright E2E — ADRA Frontends

Guidance for E2E tests in adra-frontends using @nuxt/test-utils/playwright, @adra-network/testing-utilities, and Nx targets.

When to apply

  • Adding or fixing files under frontends/*/tests/e2e/
  • Debugging flaky timeouts, auth redirects, or "element not found"
  • Deciding serial vs parallel test execution
  • Setting up .env.test:e2e, .env.build-static, or .env.playwright
  • Reviewing E2E PRs for selector/waiting anti-patterns

Workflow checklist

  1. Run through Nx — pnpm exec nx test:e2e <app> (never raw playwright test for normal runs)
  2. Use generated config — @adra-network/testing-utilities/nuxt in extends; config lives in .nuxt/playwright.config.ts (regenerated by nx prepare)
  3. Navigate with createPathHelper() — CI prefixes app name; local does not
  4. Wait on UI signals — expect(...).toBeVisible() after domcontentloaded; no waitForTimeout
  5. Select with data-testid — add testids to components instead of CSS classes
  6. Choose isolation model — parallel by default; serial when tests share mutable backend state
  7. Debug one test — pnpm exec nx test:e2e <app> -- --grep "partial title"

Quick reference (read rule files for detail)

RuleTopic
run-via-nx-not-playwright-cliNx targets, env loading, cache
use-createpathhelper-and-env-filesPaths, .env.test:e2e, auth creds
selectors-data-testid-not-cssStable locators
waiting-and-assertionsexpect(), async data, negative checks
auth-storage-stateDefault auth, public pages, .no-auth-setup
serial-vs-parallel-workersWorkers, fullyParallel, mode: 'serial'
shared-state-and-test-isolationSame org/entity, helpers, reload
debugging-and-running-subsetsgrep, single test, parallel nx invocations

Architecture (one diagram)

nx test:e2e app
  → nx prepare (regenerates .nuxt/playwright.config.ts)
  → webServer: build-static once + serve :4173
  → auth setup (@playwright/test, cached playwright/.auth/auth.json)
  → ADRA-tests (@nuxt/test-utils/playwright, build: false against static server)

Local config defaults (packages/testing-utilities/playwright.config.ts):

  • workers: WORKERS_COUNT (default 6) when static server URL is set
  • fullyParallel: true when server URL is set
  • test.describe.configure({ mode: 'serial' }) overrides — forces 1 worker for that file/group

File layout

frontends/my-app/
  tests/e2e/
    landing-page.test.ts          # public → test.use storage reset
    organizations-authenticated.test.ts
    helpers/                      # shared navigation/setup
  .env.test:e2e                   # OM_TEST_ORG_ID, DPM_TEST_ORG_ID, …
  .env.build-static               # SENTRY_DSN, build-time vars

Repo root: .env.playwright (gitignored) for AD_TESTING_AUTH_*.

Related cortex-hub skills

  • frontend-best-practices → testing-utilities-use-createpathhelper (short path/auth primer)
  • ADRA repo rules: .cursor/rules/e2e-testing-guide.mdc, .cursor/rules/nx-env-and-testing.mdc

Real examples in adra-frontends

PatternFile
Public landingfrontends/directory/tests/e2e/landing-page.test.ts
Authenticated listfrontends/directory/tests/e2e/organizations-authenticated.test.ts
Serial + shared org + helpersfrontends/office-manager/tests/e2e/org-contact-validation.test.ts
Public app (no auth setup)frontends/donation-page-receiver/tests/e2e/.no-auth-setup

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/handbook.adra.dev/playwright-e2e-adra">View playwright-e2e-adra on skillZs</a>