# Run your first test

***

## Prerequisites

* Finalrun desktop app installed ([Installation Guide](https://finalrun.gitbook.io/docs/running-test/running-test-on-local-device/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**

{% content-ref url="../managing-apps/uploading-apps-from-platform" %}
[uploading-apps-from-platform](https://finalrun.gitbook.io/docs/managing-apps/uploading-apps-from-platform)
{% endcontent-ref %}

***

## 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 "user@example.com" in the email field
Enter "password123" in the password field
Tap the "Sign In" button
Wait for 3 seconds
Verify the home screen displays
```

5. 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:

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Supported Actions</strong></td><td>Full reference of all available test actions</td><td><a href="../test-creation/supported-actions">supported-actions</a></td></tr><tr><td><strong>Real-World Examples</strong></td><td>Common testing patterns and complete flow examples</td><td><a href="../test-creation/real-world-examples">real-world-examples</a></td></tr><tr><td>Running TestSuite</td><td>Run a collection of test</td><td><a href="../running-test/running-testsuite">running-testsuite</a></td></tr><tr><td><strong>Data-Driven Testing</strong></td><td>Run tests with multiple data sets</td><td><a href="../running-test/running-same-test-on-multiple-data">running-same-test-on-multiple-data</a></td></tr><tr><td><strong>CI Integrations</strong></td><td>Automate tests in your CI/CD pipeline</td><td><a href="../ci-integrations">ci-integrations</a></td></tr></tbody></table>
