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. Running on CI — JVM flags, xvfb, macOS helper JVMs, and recording tags.
9. Recording and screenshots — region capture, window-targeted video, and native still-window screenshots.
10. Cross-JVM access — driving a UI hosted in another JVM.
11. IntelliJ-hosted Compose — Jewel-on-IntelliJ tool windows.
12. 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.