MavsterDocs
Interactions Reference

Built-In commands

Mavster's eight built-in system commands — Go Home, Go Back, Open Application, Terminate Application, Hit Return, Clear Text, Hit Backspace, Tap to Dismiss.

The Built-In tile lets you pick from a fixed menu of system commands — navigation, app control, and keyboard helpers. Some commands need a "Details" value, others don't.

Settings

The Built-In editor exposes:

FieldWhat it does
Command*One of the eight commands listed below.
DetailsOnly shown when the selected command needs a value (e.g. an app name for Open Application). The placeholder text changes based on the chosen command.
Select Built-In Interaction modal: Command picker open showing the eight commands in order, with Open Application selected and the Details field showing the placeholder 'Enter application name'.

The eight commands

The Command picker shows these in order. Display titles below match what you see in the picker.

Go Home

Sends the device to its home screen.

No Details value.

Go Back

Android-only. Sends the system back gesture. On iOS this command is a no-op; use the app's own back button or an edge-swipe Drag instead.

No Details value.

Open Application

Launches an app on the bound device.

Details placeholder: "Enter application name". Type the human name (e.g. Settings, Maps, your-app-name); Mavster resolves it to the right app.

Terminate Application

Force-quits the foreground app.

Details placeholder: "Application name". Optional — leave empty to terminate the last opened app.

Hit Return Key

Sends the Return / Enter key to the focused field.

No Details value.

Clear Text

Clears the text in the focused field.

No Details value.

Hit Backspace Key

Sends N backspace keys to the focused field.

Details placeholder: "Enter backspace count (e.g. 20)". Defaults to 1 when you switch to this command.

Tap to Dismiss

Taps a "safe" empty area to dismiss the keyboard, popovers, or modal overlays.

No Details value.

What's possible

  • Resetting the device to a clean state at the top of a test: Go Home → Terminate Application → Open Application.

  • Clearing a search field reliably: Clear Text → Tap (the field) → Keyboard Type (the new query).

  • Dismissing the iOS keyboard before scrolling under it: Tap to Dismiss → Scroll.

  • Submitting forms by hitting Return without dragging the cursor to a Submit button: Keyboard Type → Hit Return Key.

What's not possible

  • Triggering arbitrary system shortcuts (e.g. iOS Control Centre, App Switcher) — only the eight commands above are supported.

  • iOS Go Back — see Go Back above; use a Drag (edge-swipe) or the app's own back affordance.

  • Granting permissions inside system dialogs — Mavster will tap them like any other element via Tap, but there's no Built-In for permissions.

Common patterns

  • Test setup: Go Home → Terminate Application (your app) → Open Application (your app). Three-line clean reset.

  • Form submit: Tap (field) → Keyboard Type → Hit Return Key.

  • Dismiss-then-act: Tap to Dismiss → Scroll / Tap.