electron-playwright-validator

Solid

Validate Electron desktop app UI using Playwright automation via the e-cli tool. Use when testing Electron app UI, validating after code changes, checking if tabs render, clicking through UI flows, taking screenshots for visual review, or debugging runtime import errors that typecheck doesn't catch. Works with any Electron project that has @playwright/test and electron in devDependencies. Use when the user asks "validate the electron app", "check the UI", "click through the app", "take a screenshot", "does the app render", "test the electron UI", "launch the app and check", "verify the app works", "is the app broken", or "debug a runtime error". NOT for native macOS (SwiftUI/AppKit) apps — use the peekaboo macOS validator — and NOT for mobile apps (use the Maestro validator).

Testing & QA 11 stars 0 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
36
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Electron Playwright Validator Validate Electron desktop apps by launching them with Chrome DevTools Protocol (CDP) and automating the UI via Playwright. The `e-cli` tool provides a persistent session model: launch the app once (~5s startup), then run fast CDP-connected commands (~200ms each) to inspect, click, screenshot, and validate. ## Setup — resolve the tool path first `e-cli` ships inside this plugin and is NOT on PATH. Define this once per session and use it for every invocation: ```bash E_CLI="${CLAUDE_PLUGIN_ROOT}/bin/e-cli" "$E_CLI" --help ``` Every `e-cli <cmd>` in this document means `"$E_CLI" <cmd>`. The tool resolves `electron` and `playwright` from the **project's** node_modules — run it from the project root; nothing is installed globally. ## Core Workflow Follow this sequence for every validation session: 1. **Launch** — `e-cli launch` starts the Electron app with CDP enabled. Auto-builds if `out/main/index.js` is missing. 2. **Snapshot** — `e-cli snapshot` dumps the full accessibility tree. This is how you "see" the UI. 3. **Interact** — Use `e-cli click`, `e-cli fill`, `e-cli press` to navigate and interact. 4. **Validate** — After each interaction, snapshot again to verify the UI updated correctly. Use `e-cli screenshot` + `Read` tool for visual confirmation. 5. **Close** — `e-cli close` terminates the app and cleans up state. Always close the app when done. A lingering Electron process blocks subsequent launches. ## Reading the Accessibility T...

Details

Author
johnkozaris
Repository
johnkozaris/jko-claude-plugins
Created
4 months ago
Last Updated
yesterday
Language
Rust
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category