Run your first test

Run your first test in a minute

---

Prerequisites

• Finalrun desktop app installed (Installation Guide)

• Your mobile app ready to test (.apk for Android, .app/.ipa for iOS)

---

Step 1: Upload Your App

1. Open the Finalrun app and navigate to Apps

2. Click Create New App

3. Fill in your app details:

   • App Name (e.g., "My App")

4. Drag and drop your app file or click to browse

5. Click Upload

Checkout in detail how to manage and upload apps

Uploading Apps from platform

---

Step 2: Create Your First Test

1. Navigate to Tests from the sidebar

2. Click Create New Test

3. Give your test a name (e.g., "Login Flow")

4. Write your test steps in plain English:

Tap the "Login" button
Enter "[e-mail]" in the email field
Enter "password123" in the password field
Tap the "Sign In" button
Wait for 3 seconds
Verify the home screen displays

1. Click Save

---

Step 3: Run Your Test

1. Find your test in the Tests list

2. Click the Run button

3. Select the device to run on

4. Click Run

Watch as Finalrun executes each step on the device in real-time.

---

Step 4: View Results

After the test completes:

1. Click on the test run to open results

2. View detailed information including:

   • ✅ Pass/Fail status for each step

   • 📸 Screenshots and Videos captured at each step

   • ⏱️ Execution timeline

   • ⚠️ Any errors encountered

---

Next Steps

Now that you've run your first test, explore more:

Supported Actions

Full reference of all available test actions

Real-World Examples

Common testing patterns and complete flow examples

Running TestSuite

Run a collection of test

Data-Driven Testing

Run tests with multiple data sets

CI Integrations

Automate tests in your CI/CD pipeline