# Playwright with JUnit

Your guide to running tests using JUnit SDK on BrowserStack’s Playwright Grid of 100+ browser-OS combinations.

This section covers running your first build with BrowserStack’s sample repo. To run builds with your existing test suite(s), skip to [integrate your test suite](/content/docs/automate/playwright/getting-started/integrate-your-tests/index.html).

#### Onboard faster with Test Companion

Launch in your IDE. Chat with the AI assistant to configure and run your first build instantly.

## Prerequisites

- BrowserStack Username and Access key. You can find this in your [account profile](/content/accounts/profile/details/index.html). If you have not created an account yet, you can [sign up for a Free Trial](/content/users/sign_up/index.html).
- JUnit, Java v8+ is installed on your machine.
- If you are using CLI for running tests, ensure that Maven is installed on your machine, [Maven](https://maven.apache.org/install.html) environment variables are set, and Maven bin is added to system path, `$PATH`.

## Run a sample build

### Clone sample repository

Clone our sample Git repository using the following command:

```bash
# clone sample junit repository
git clone https://github.com/browserstack/java-playwright-browserstack.git
cd java-playwright-browserstack
```

### Compile the project

Compile the source code of the project by running the following command in your terminal/command-line:

```bash
mvn compile
```

### Configure your browserstack.yml config file

The `browserstack.yml` file holds all the required capabilities to run your tests on BrowserStack

#### Set access credentials

Set `userName` and `accessKey` properties in `browserstack.yml` to authenticate your tests on BrowserStack.

#### Specify platforms to test on

Set the browsers/OS you want to test under the `platforms` object. Select over 100+ browsers-OS combinations from the list of [supported browsers and OS](/content/list-of-browsers-and-platforms/playwright/index.html)

#### Update the browserstack.yml config file

Copy and replace the following config in the `browserstack.yml` file available in the root directory of the project.

```yml
userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
  - YOUR_FIRST_OS_TYPE: YOUR_FIRST_OS
    YOUR_FIRST_OS_VERSION_TYPE: YOUR_FIRST_OS_VERSION
    YOUR_FIRST_BROWSER_TYPE: YOUR_FIRST_BROWSER
    YOUR_FIRST_BROWSER_VERSION_TYPE: YOUR_FIRST_BROWSER_VERSION
  - YOUR_SECOND_OS_TYPE: YOUR_SECOND_OS
    YOUR_SECOND_OS_VERSION_TYPE: YOUR_SECOND_OS_VERSION
    YOUR_SECOND_BROWSER_TYPE: YOUR_SECOND_BROWSER
    YOUR_SECOND_BROWSER_VERSION_TYPE: YOUR_SECOND_BROWSER_VERSION
  - YOUR_THIRD_OS_TYPE: YOUR_THIRD_OS
    YOUR_THIRD_OS_VERSION_TYPE: YOUR_THIRD_OS_VERSION
    YOUR_THIRD_BROWSER_TYPE: YOUR_THIRD_BROWSER
    YOUR_THIRD_BROWSER_VERSION_TYPE: YOUR_THIRD_BROWSER_VERSION
selfHeal: YOUR_SELF_HEAL
```

### Execute build on BrowserStack

You are now ready to run your build on BrowserStack. From the root directory of the project, run the following command.

```bash
mvn test -P sample-test
```

### View test results

View your tests on the [BrowserStack Automate dashboard](https://automate.browserstack.com/). To learn more about the dashboard, check the [view test results](/content/docs/automate/playwright/view-test-results/index.html) document.

## Next steps

After you have successfully run your first test on BrowserStack, try [integrating your test suite with BrowserStack](/content/docs/automate/playwright/getting-started/integrate-your-tests/index.html).