sanderling/docs/index.md

title

title
Sanderling Manual

Sanderling Manual

sanderling tests mobile and web apps by exploring them on its own and checking rules you write. You state properties that must always hold ("a new account starts at zero", "the app never throws"). sanderling drives the app for minutes or hours through thousands of taps, swipes, and inputs, and records every step where a property breaks. One TypeScript spec runs against Android, iOS, and web builds of the same app.

Alpha: the scope of v0.1.0 is tracked in issue #4.

Manual

• Introduction: what property-based testing is and how sanderling works.
• Getting started: install and run a first test against the example app.
• Writing specs: build a real spec from scratch, one concept at a time.
• Spec language reference: every selector, operator, action, and sampler.
• Runs: what happens during a run and why runs are long.
• Replay: the trace browser.
• CLI reference: every command and flag.

Development

• Architecture and design principles for contributors.

---

sanderling, a wading bird that probes the shoreline for bugs that lie beneath.