Skip to content

modem-dev/ossrules / public/files/qwik/.ruler/skills/qwik-e2e-verification

qwik-e2e-verification

Verified

Use when creating, modifying, debugging, or running Qwik Playwright e2e tests under e2e/, including router, adapters, docs, CLI, and React integration suites.

FileKindSize
SKILL.mdskill md3.6 KB
---
name: qwik-e2e-verification
description: Use when creating, modifying, debugging, or running Qwik Playwright e2e tests under e2e/, including router, adapters, docs, CLI, and React integration suites.
---

# Qwik E2E Verification

Use this skill for Playwright e2e work in `e2e/**`. Keep the repo-wide rules from
`.ruler/AGENTS.md` in force.

## Fast Path

1. Identify the suite: Qwik core app, Qwik Router, adapters, docs, CLI, or Qwik React.
2. Run the dev rebuild first when testing Qwik runtime/router behavior.
3. Use the suite's Playwright config and the browser-selection style that config expects.
4. Prefer one focused e2e file before broad suite commands.
5. When debugging app fixtures, inspect the matching `e2e/*/apps/` source before changing tests.
6. Turn a failing behavior into the smallest deterministic regression. Avoid sleeps and broad
   assertions when a route, marker, event, or serialized state check can prove the behavior.

## Suites

- Main Qwik e2e: `e2e/qwik-e2e/tests/`
- Router e2e: `e2e/qwik-e2e/tests/qwikrouter/`
- Adapter e2e: `e2e/adapters-e2e/tests/`
- Docs e2e: `e2e/docs-e2e/tests/`
- CLI e2e: `e2e/qwik-cli-e2e/tests/`
- React integration e2e: `e2e/qwik-react-e2e/tests/`

## Commands

Main Qwik e2e config uses `--browser`, not Playwright projects:

```bash
pnpm build.core.dev
pnpm playwright test e2e/qwik-e2e/tests/events.e2e.ts --browser=chromium --config e2e/qwik-e2e/playwright.config.ts
pnpm playwright test e2e/qwik-e2e/tests/qwikrouter/nav.e2e.ts --browser=chromium --config e2e/qwik-e2e/playwright.config.ts
```

Other suites may use named Playwright projects. Check their config before choosing flags:

```bash
pnpm playwright test e2e/docs-e2e/tests/docs-smoke.spec.ts --config e2e/docs-e2e/playwright.config.ts --project chromium
pnpm playwright test e2e/adapters-e2e/tests/adapters.spec.ts --project=chromium --config e2e/adapters-e2e/playwright.config.ts
pnpm playwright test e2e/qwik-react-e2e/tests/reactify.spec.ts --project=chromium --config e2e/qwik-react-e2e/playwright.config.ts
```

## SSG snapshot suite

`e2e/qwik-e2e/tests/qwikrouter/ssg-snapshot.e2e.ts` asserts two independent things against the built
`qwikrouter-ssg-snapshot` app:

- **Serialized output goldens** — `expected.state.txt` and `expected.ssg.html`. Regenerate after an
  intentional serialization or SSR output change with `pnpm test.e2e.router.ssg.update`.
- **Brotli size budgets** — `CORE_BROTLI_BUDGET` / `PRELOADER_BROTLI_BUDGET` /
  `QWIKLOADER_BROTLI_BUDGET` constants in that spec. A core change that grows a bundle fails with the
  exact over-budget byte count; bump the matching constant when the growth is intentional.

Traps:

- `test.e2e.router.ssg.update` regenerates the goldens only; it never touches the budgets, so a
  budget breach survives the update.
- The update run can exit non-zero because a sibling budget assertion failed, not the golden. "N
  passed" with exit 1 usually means a budget breach — read the failing assertion instead of assuming
  the golden is stale.
- After rebasing onto a moved base the golden conflicts; regenerate it rather than hand-merging, then
  re-run `pnpm test.e2e.router.ssg` (no update flag) to confirm it passes deterministically.

## Stop Conditions

- Stop and inspect the suite config when `--browser` versus `--project` is unclear.
- Stop and report if browser binaries, build artifacts, or dependencies are missing.
- Do not broaden to all e2e suites unless the user asks or the changed surface requires it.
- If a test failure shows this skill has stale suite or command guidance, update the skill before
  finishing or record why guidance edits were out of scope.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall