Writing tests

The .tl format

Testral tests use the .tl format: optional metadata directives at the top, then plain-English steps — one natural-language command per line.

appid com.android.chrome
name Visit Testral

Launch Chrome
If existing close any welcome popup
Focus the google search and type "testral.dev"
Open the website
verify "Testral" is visible

Directives

• appid / bundleId — target package or bundle used by launch / clear / kill when no app is named on the line
• name — human-readable test name

Authoring tips

• Write steps the way you would instruct a teammate: tap labels, type into fields, verify what you see.
• Use autocomplete in the editor — start typing on a blank line for common commands.
• Tests auto-save as you edit.
• Prefer if existing … for optional one-time dialogs (cookies, tips, permissions).