Automate and scale manual testing with AI ->

Getting Started with TestDriver

TestDriver is an AI-powered end-to-end testing platform that lets you write tests in plain English and run them against any web application. This guide will help you get up and running quickly.

Prerequisites

Before you begin, make sure you have:

• Node.js 18+ installed on your machine
• A GitHub account for CI/CD integration
• Your web application running locally or deployed

Installation

Install the TestDriver CLI globally:

npm install -g testdriverai

Or add it to your project as a dev dependency:

npm install --save-dev testdriverai

Your First Test

Create a test file named login.yml in your project root:

version: 4
steps:
  - prompt: Navigate to https://yourapp.com
  - prompt: Click the "Sign In" button
  - prompt: Type "[email protected]" in the email field
  - prompt: Type "password123" in the password field
  - prompt: Click "Log In"
  - prompt: Assert that the dashboard is visible

Run your test with:

testdriver run login.yml

GitHub Actions Integration

Add TestDriver to your CI pipeline by creating .github/workflows/testdriver.yml:

name: TestDriver E2E Tests
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run TestDriver
        uses: testdriverai/action@main
        with:
          key: ${{ secrets.TESTDRIVER_API_KEY }}
          prompt: |
            1. Navigate to the application
            2. Test the login flow
            3. Verify the dashboard loads

Understanding AI Test Results

TestDriver provides detailed results including:

• Screenshots at each step
• Video recordings of the full test run
• AI analysis of any failures
• Performance metrics for page loads

Next Steps

Now that you have your first test running, explore:

• Writing Effective Tests — best practices for reliable AI tests
• CI/CD Integration Guide — advanced pipeline configuration
• Full Documentation — complete API and configuration reference