Guide

The guide walks through using Spectre end-to-end:

1. Installation — how to consume Spectre while it's pre-release.
2. Getting started — write your first test against a Compose Desktop window.
3. The automator — the mental model: surfaces, the semantics tree, queries vs. interactions, and why there's no auto-wait.
4. Finding nodes — selector reference.
5. Driving input — clicks, swipes, scrolling, typing, screenshots.
6. Synchronization — wait helpers and the EDT rule.
7. JUnit integration — ComposeAutomatorExtension (JUnit 5) and ComposeAutomatorRule (JUnit 4).
8. Recording — region and window-targeted screen capture.
9. Cross-JVM access — driving a UI hosted in another JVM.
10. IntelliJ-hosted Compose — Jewel-on-IntelliJ tool windows.
11. Troubleshooting — platform-specific gotchas.

If you're new to Spectre, start with Installation and Getting started, then read The automator before dipping into the per-topic pages.