# paragon-libs

> Updated library support for paragon test automation framework with webdriverIO 9

Latest version **4.0.1** (published 2025-09-03) · ISC license · 0 weekly downloads

## Install

```sh
npm install paragon-libs
pnpm add paragon-libs
yarn add paragon-libs
bun add paragon-libs
```

## Health

**Score 30/100 (F)** — status: maintenance-mode.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 4.0.1 |
| Published | 2025-09-03 |
| First published | 2019-05-27 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 37.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Naveen Dhingra |
| Maintainers | naveen.dhingra |

## Links

- npm: https://www.npmjs.com/package/paragon-libs
- npm.io page: https://npm.io/package/paragon-libs

## Recent versions

- 4.0.1 (latest) — 2025-09-03
- 4.0.0 — 2025-07-30
- 3.3.4 — 2025-07-30
- 3.3.3 — 2024-03-08
- 3.3.2 — 2021-07-19
- 3.3.1 — 2021-05-11
- 3.3.0 — 2021-03-23
- 3.2.4 — 2020-10-13
- 3.2.3 — 2020-10-08
- 3.2.2 — 2020-10-08
- 3.2.0 — 2020-10-08
- 3.1.0 — 2020-06-30
- 3.0.2 — 2020-06-23
- 3.0.1 — 2020-06-22
- 3.0.0 — 2020-06-18
- … 20 more at https://npm.io/package/paragon-libs/versions

## README

# Paragon - Test automation framework for mobile & apis.

Paragon is a webdriverIO Cucumber based test automation framework for mobile apps that provides a standard mechanism for the configuration & running of test suites.

![alt text] (<http url to paragon.png>)

## Requirements

In order to get started, you'll need to install:

* Node.js (see user guide - )
* XCode (see user guide - )
* Android Studio (see user guide - )
* Gulp - on your command line execute 
    `npm i -g gulp`
* Appium - on your command line execute
    `npm i -g appium`
* Appium Doctor - on your command line execute
    `npm i -g appium-doctor`

Note: In case of permission denied error, please try with `sudo`  or else fix ownership of usr/lib/local drive by typing following command:
    `sudo chown -R $USER /usr/local/lib`

## Setup envoirnment variable

Open you Terminal and type `open -e ~/.bash_profile` . 
if file not availble, create one using `touch ~/.bash_profile`

Edit your bash profile file with following envoirnment variables enteries (please ensure details are specific to your machine)
* export ANDROID_HOME="/Users/<username>/Library/Android/sdk"
* export JAVA_HOME="/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home"
* Append to your PATH variable with `${ANDROID_HOME}/emulator:${ANDROID_HOME}/tools:$ANDROID_HOME/platform-tools:${ANDROID_HOME}/build-tools/29.0.0-rc2:${JAVA_HOME}/bin`

Close the terminal and restart terminal again, verify your env path by typing following commands
* echo $JAVA_HOME 
* echo $ANDROID_HOME

These commands should return path to corresponding sdks

## appium-doctor verification

Open your terminal and run command `appium-doctor`.

* please ensure all necessary dependencies are ticked marked and fix any crosses dependencies. 

Now you're ready to get started!

## Getting Started

To get started with Paragon in your project, first ensure you have installed the requirements above, then open a command line and navigate to your projects directory.

Once you are in your projects directory, clone paragon from git repository:

`git clone https://tfsweb.intranet.bbl/tfs/BBLCollection/Modern-App/_git/testautomation`

Now you need to install all dependencies required for the project. You can do this by executing following command:

`npm install`

## Command line

you are now ready to run your first test. type following command:

for iOS
`gulp test:ios --ff "<featureFile name>" --args "<tags>"`

for Android
`gulp test:android --ff "<featureFile name>" --args "<tags>"`

## Configuration

All of the configuration for paragon is contained within the <android/ios>.conf.js file, see the options below for more information regarding configuration:

* [Test Configuration](docs/testing.md)
* [User guide](docs/userguide.md)

---
_Source: https://npm.io/package/paragon-libs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
