-
Notifications
You must be signed in to change notification settings - Fork 17
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #131 from LambdaTest/stage
Release 4.0.6
- Loading branch information
Showing
10 changed files
with
389 additions
and
304 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,6 +1,6 @@ | ||
{ | ||
"name": "@lambdatest/smartui-cli", | ||
"version": "4.0.5", | ||
"version": "4.0.6", | ||
"description": "A command line interface (CLI) to run SmartUI tests on LambdaTest", | ||
"files": [ | ||
"dist/**/*" | ||
|
@@ -21,10 +21,10 @@ | |
"author": "LambdaTest <[email protected]>", | ||
"license": "MIT", | ||
"dependencies": { | ||
"@playwright/browser-chromium": "^1.45.3", | ||
"@playwright/browser-firefox": "^1.45.3", | ||
"@playwright/browser-webkit": "^1.45.3", | ||
"@playwright/test": "^1.45.3", | ||
"@playwright/browser-chromium": "^1.47.2", | ||
"@playwright/browser-firefox": "^1.47.2", | ||
"@playwright/browser-webkit": "^1.47.2", | ||
"@playwright/test": "^1.47.2", | ||
"@types/cross-spawn": "^6.0.4", | ||
"@types/node": "^20.8.9", | ||
"@types/which": "^3.0.2", | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,47 +1,68 @@ | ||
# SmartUI CLI | ||
[![SmartUI-Testing](https://smartui.lambdatest.com/static/media/LTBadge.64a05e73.svg)](https://smartui.lambdatest.com) | ||
# SmartUI-CLI | ||
|
||
The SmartUI CLI is used to create configs, take screenshots and upload to [SmartUI Dashboard](https://smartui.lambdatest.com/) via | ||
the command line. | ||
<img height="400" src="https://user-images.githubusercontent.com/126776938/232535511-8d51cf1b-1a33-48fc-825c-b13e7a9ec388.png"> | ||
|
||
<p align="center"> | ||
<a href="https://www.lambdatest.com/blog/?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample" target="_bank">Blog</a> | ||
⋅ | ||
<a href="https://www.lambdatest.com/support/docs/?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample" target="_bank">Docs</a> | ||
⋅ | ||
<a href="https://www.lambdatest.com/learning-hub/?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample" target="_bank">Learning Hub</a> | ||
⋅ | ||
<a href="https://www.lambdatest.com/newsletter/?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample" target="_bank">Newsletter</a> | ||
⋅ | ||
<a href="https://www.lambdatest.com/certifications/?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample" target="_bank">Certifications</a> | ||
⋅ | ||
<a href="https://www.youtube.com/c/LambdaTest" target="_bank">YouTube</a> | ||
</p> | ||
  | ||
  | ||
  | ||
|
||
|
||
|
||
[<img height="58" width="200" src="https://user-images.githubusercontent.com/70570645/171866795-52c11b49-0728-4229-b073-4b704209ddde.png">](https://accounts.lambdatest.com/register?utm_source=github&utm_medium=repo&utm_campaign=playwright-sample) | ||
|
||
|
||
The **SmartUI-CLI** allows you to capture visual snapshots of your web applications, upload images, and run visual regression tests using [LambdaTest's SmartUI](https://www.lambdatest.com/visual-regression-testing) platform directly from the command line. | ||
|
||
- [Installation](#installation) | ||
- [Start using CLI](#start-using-cli) | ||
- [Commands](#commands) | ||
- [Documentation](#documentation) | ||
- [Issues](#issues) | ||
|
||
## Installation | ||
|
||
```sh-session | ||
$ npm install -g @lambdatest/smartui-cli --force | ||
$ npm install smartui-cli | ||
``` | ||
|
||
## Start using CLI | ||
**Note:** | ||
If you face any problems executing tests with SmartUI-CLI `versions >= v4.x.x`, upgrade your Node.js version to `v20.3` or above. | ||
|
||
#### Create URL Json file | ||
```sh-session | ||
$ smartui config:web-static urls.json | ||
``` | ||
## Commands | ||
- `npx smartui exec` - Capture DOM assets for visual testing across multiple browsers and resolutions. | ||
- `npx smartui capture` - Bulk capture static URLs for visual testing. | ||
- `npx smartui upload` - Upload custom images or screenshots for visual comparison. | ||
- `npx smartui upload-figma` - Upload Figma design images for visual comparison. | ||
- `npx smartui config` - Creates configuration file according to the usecase. | ||
|
||
#### Create custom Web Config file | ||
```sh-session | ||
$ smartui config:create-web smartui-web.json | ||
``` | ||
### Documentation | ||
|
||
#### Configure your Project Token | ||
In addition to its core functionalities, the SmartUI CLI leverages LambdaTest's cloud infrastructure for robust, scalable visual regression testing across various browsers and devices. | ||
|
||
Create a new web project from [SmartUI Dashboard](https://smartui.lambdatest.com/) and copy the project token and set on CLI via command | ||
- [SmartUI Selenium SDK](https://www.lambdatest.com/support/docs/smartui-selenium-java-sdk) - A complete SDK to capture DOM assets for visual tests. | ||
- [LambdaTest Documentation](https://www.lambdatest.com/support/docs/) - Official LambdaTest documentation for SmartUI and other integrations. | ||
- [Bulk capturing static URLs with SmartUI](https://www.lambdatest.com/support/docs/smartui-cli/) - Documentation for capturing satatic urls in bulk with SmartUI | ||
- [Bring your own screenshots](https://www.lambdatest.com/support/docs/smartui-cli-upload/) - Documentation for capturing satatic urls in bulk | ||
- [Figma CLI](https://www.lambdatest.com/support/docs/smartui-cli-figma/) - Documentation for uploading figma components to SmartUI | ||
|
||
<b>For Linux/macOS:</b> | ||
### Issues | ||
|
||
``` | ||
export PROJECT_TOKEN="****-****-****-************" | ||
``` | ||
If you encounter problems with SmartUI-CLI, [add an issue on GitHub](https://github.com/LambdaTest/smartui-cli/issues/new). | ||
|
||
<b>For Windows:</b> | ||
For other support issues, reach out via [LambdaTest Support](https://www.lambdatest.com/support). | ||
|
||
``` | ||
set PROJECT_TOKEN="****-****-****-************" | ||
``` | ||
|
||
#### Capture Screenshots | ||
```sh-session | ||
$ smartui capture urls.json --config smartui-web.json | ||
``` | ||
------ | ||
|
||
[Know more](https://www.lambdatest.com/visual-regression-testing) about SmartUI and it's AI enabled comparison engines. |
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
Oops, something went wrong.