diff --git a/README.md b/README.md index 464d8119..265f0fc6 100644 --- a/README.md +++ b/README.md @@ -1,39 +1,82 @@ -# smartui-github-testing +
+ + Blog + ⋅ + Docs + ⋅ + Learning Hub + ⋅ + Newsletter + ⋅ + Certifications + ⋅ + YouTube +
+ + + +*Learn the how to get started with testing GitHub app integration with SmartUI on the LambdaTest platform.* -### Getting Started Github App Integration with SmartUI Product - Selenium Automation +[
](https://accounts.lambdatest.com/register?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample)
-Steps 1: Setup Github App with lambdatest from link github setup
+
+## Table of Contents:
+
+* [Pre-requisites](#pre-requisites)
+* [Getting Started With Github App Integration with SmartUI](#getting-started-with-github-app-integration-with-smartui)
+
+
+## Pre-requisites
+
+* An account with Github with valid permission to install new applications to your repositories.
+* Basic understanding of Continuos Integration tools (CI) is required.
+* Should have setup the SmartUI suite, else please read [this](https://www.lambdatest.com/support/docs/selenium-visual-regression/).
+
+## Getting Started With Github App Integration with SmartUI
+
+### Steps 1: Integrate the your Lambdatest Account with GitHub App.
+
+You can integrate your LambdaTest account with the GiHub application in the following ways:
- Using OAuth
-- Cloud, or
+
-- Self Hosted
-Step 2: Once setup is done, you will see like
+### Step 2: Select your GitHub repository
-Step 3: Now you need to setup a sample repository where your test case are mentioned, [smartui-github-testing](https://github.com/LambdaTest/smartui-github-testing)
+Go to your GitHub repository where you want to configure your SmartUI project. Check out our GitHub sample [here](https://github.com/LambdaTest/smartui-node-sample).
-Step 4: For Github Status updates on PR/ commit need to add capabilities in test suite,
+### Step 3: Configure your test suite
-```
- github: {
- "url": "https://api.github.com/repos/OWNER/REPO/statuses/commitId",
- "owner": "{OWNER}", //Optional
- "repo": "{REPO}", //Optional
- "commit": "{commitId}" //Optional
- },
+Add the `Github` capability to your current test configuration:
+
+```bash
+const capabilities: {
+ platform: "Windows 10",
+ browserName: "chrome",
+ version: "latest",
+ "smartUI.project": "Smart UI sample test",
+ github: {
+ "url": "https://api.github.com/repos/OWNER/REPO/statuses/commitId", // Mandatory
+ "owner": "{OWNER}", //Optional
+ "repo": "{REPO}", //Optional
+ "commit": "{commitId}" //Optional
+ }
+}
```
-Step5: How to get the `github.url` value in test suite
+### Step 4: Setting up your CI configuration
-Here we have taken an example of github action, Add below steps in your github action file [.github/workflows/ci.yml](https://github.com/LambdaTest/smartui-github-testing/blob/main/.github/workflows/ci.yml)
+Setting up your CI workflow to execute on GitHub. Here is an example setup with `GitHub Actions`:
-```
+Go to `.github/workflows/
](https://accounts.lambdatest.com/register?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample)
+
+## We are here to help you :headphones:
-Step 6: Commit you changes over git on a branch and raise the PR to main branch
+* Got a query? we are available 24x7 to help. [Contact Us](mailto:support@lambdatest.com)
+* For more info, visit - [LambdaTest](https://www.lambdatest.com/?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample)
-Step 7: Now you will see the `lambdatest-smartui-app` check in the PR