From Appium
Move web journeys from Appium coverage to Smoketest while keeping native mobile tests in Appium.
Smoketest runs browser tests. It does not replace native iOS or Android app automation.
If your Appium suite covers mobile web, responsive web, or shared backend journeys that can run in a browser, those are good candidates for Smoketest. Keep native app tests, device capabilities, biometric tests, camera access, and app-install coverage in Appium.
Translate the concepts
| Appium | Smoketest |
|---|---|
| Mobile-web test method | One browser test |
driver.get() or browser navigation | Start URL or navigation step |
tap, click, sendKeys, swipe on web UI | Action step in words |
| Assertion on visible web state | Verification step in words |
| Login helper | Login sharedStep or environment-backed login steps |
| Desired capabilities | Usually not needed for browser tests |
| Native app build and device farm | Keep in Appium |
What to migrate
Migrate Appium tests that open a web URL or validate behavior shared with your desktop web app. Examples include signup, login, account settings, checkout, documentation search, or responsive navigation.
Do not migrate native app-only tests to Smoketest. Use Appium for native screens, app permissions, push notifications, deep links into installed apps, and physical-device-only behavior.
Quick migration prompt
Use $smoketest-explore to review this repository's Appium suite and draft Smoketest tests only for browser-based user journeys.
1. Check Smoketest CLI install and auth first.
2. Find Appium tests, screen/page objects, and desired capabilities.
3. Separate browser/mobile-web journeys from native app journeys.
4. Convert only the browser journeys into .smoketest/explore test drafts.
5. Drop capabilities, device setup, Appium server setup, waits, and locators.
6. Mark native-only coverage as skipped with a reason.
7. Use Smoketest environments for test-user credentials.
8. Validate and dry-run the manifest, then ask before applying.Example test
## Mobile web sign in
- Open the sign-in page on the web app.
- Enter the test user's email and password.
- Submit the form.
- Verify the dashboard opens and the mobile navigation is available.After migration
- Run migrated tests on the same staging URL used by your Appium web tests.
- Keep native Appium jobs for app-store builds and device-only behavior.
- Use Smoketest run recordings for web regression review.