testcentricity 2.4.3 → 3.0.0

data/README.md

@@ -1,236 +1,66 @@
-# TestCentricity™ Web
+# TestCentricity™
 
 [![Gem Version](https://badge.fury.io/rb/testcentricity.svg)](https://badge.fury.io/rb/testcentricity)  [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause)
-
-
-The TestCentricity™ Web core generic framework for desktop and mobile web site testing implements a Page Object and Data Object Model DSL for
-use with Cucumber, Capybara, and Selenium-Webdriver.
-
-The TestCentricity™ Web gem supports running automated tests against the following web test targets:
-* locally hosted desktop browsers (Firefox*, Chrome, Safari, or IE)
-* locally hosted emulated iOS Mobile Safari, Android, Windows Phone, or Blackberry mobile browsers (running within a local instance of Chrome)
-* a "headless" browser (using Poltergeist and PhantomJS)
-* mobile Safari browsers on iOS device simulators or physical iOS devices (using Appium and XCode on OS X)
-* mobile Chrome or Android browsers on Android Studio virtual device emulators (using Appium and Android Studio on OS X)
-* cloud hosted desktop (Firefox, Chrome, Safari, IE, or Edge) or mobile (iOS Mobile Safari or Android) web browsers using the [Browserstack](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate),
-[Sauce Labs](https://saucelabs.com/open-source#automated-testing-platform), [CrossBrowserTesting](https://crossbrowsertesting.com/selenium-testing), or
-[TestingBot](https://testingbot.com/features) services.
+![Gem Downloads](https://img.shields.io/gem/dt/testcentricity) ![Maintained](https://img.shields.io/maintenance/yes/2022)
+
+
+The TestCentricity™ core framework for native mobile iOS and Android apps and desktop/mobile web testing implements a Screen
+and Page Object Model DSL for use with Cucumber (version 7.x or greater), Appium, Capybara, and Selenium-Webdriver (version 4.x). It also facilitates
+the configuration of the appropriate Appium capabilities and driver required to establish a connection with locally hosted or
+cloud hosted (using BrowserStack, Sauce Labs, or TestingBot services) iOS and Android real devices or simulators. For more
+information on desktop/mobile web testing with this gem, refer to docs for the [TestCentricity™ Web gem](https://www.rubydoc.info/gems/testcentricity_web)
+
+The TestCentricity™ gem supports automated testing of native iOS and Android apps running on the following mobile test targets:
+* locally hosted iOS device simulators or physical iOS devices (using Appium and XCode on macOS)
+* locally hosted Android devices or Android Studio virtual device emulators (using Appium and Android Studio on macOS)
+* cloud hosted physical devices and simulators from the following service:
+    * [Browserstack](https://www.browserstack.com/list-of-browsers-and-platforms/app_automate)
+    * [Sauce Labs](https://saucelabs.com/platform/mobile-testing)
+    * [TestingBot](https://testingbot.com/mobile/realdevicetesting)
+
+The TestCentricity™ gem also incorporates all of the features and capabilities of the TestCentricity™ Web framework gem, which
+supports running automated tests against the following web test targets:
+* locally hosted desktop browsers (Chrome, Edge, Firefox, Safari, or IE)
+* locally hosted "headless" Chrome, Firefox, or Edge browsers
+* remote desktop and emulated mobile web browsers hosted on Selenium Grid 4 and Dockerized Selenium Grid 4 environments
+* mobile Safari browsers on iOS device simulators or physical iOS devices (using Appium and XCode on macOS)
+* mobile Chrome or Android browsers on Android Studio virtual device emulators (using Appium and Android Studio on macOS)
+* cloud hosted desktop (Firefox, Chrome, Safari, IE, or Edge) or mobile (iOS Mobile Safari or Android) web browsers using the following service:
+  * [Browserstack](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate)
+  * [Sauce Labs](https://saucelabs.com/open-source#automated-testing-platform)
+  * [TestingBot](https://testingbot.com/features)
+  * [LambdaTest](https://www.lambdatest.com/selenium-automation)
 * web portals utilizing JavaScript front end application frameworks like Ember, React, Angular, and GWT
-* enterprise web portals build using Siebel Open UI
-
-
-**Note:** Test execution against local instances of Firefox version 48 or greater is currently not supported by the TestCentricity™ Web gem. Testing with
-locally hosted instances of Firefox 48 or greater requires Marionette (aka geckodriver) and selenium-webdriver version 3.x, both of which are currently
-feature incomplete and potentially unstable. More information can be found [here](https://github.com/teamcapybara/capybara/issues/1710).
-
-TestCentricity™ will be updated to support testing with Selenium-WebDriver version 3.x as soon as a stable version is available that **fully** supports locally
-hosted instances of Chrome, Firefox, Safari, and IE web browsers.
+* web pages containing HTML5 Video and Audio objects
 
 
 ## What's New
-###Version 2.4.3
-
-* Updated device profiles for iPhone 7 (iOS 11) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.
-
-###Version 2.4.1
-
-* Added device profiles for iPad (iOS 10) with MS Edge browser.
-
-###Version 2.4.0
-
-* Updated `TestCentricity::WebDriverConnect.initialize_web_driver` method to read the `APP_FULL_RESET`, `APP_NO_RESET`, and `NEW_COMMAND_TIMEOUT` Environment
-Variables and set the corresponding `fullReset`, `noReset`, and `newCommandTimeout` Appium capabilities for iOS and Android physical devices and simulators.
-Also reads the `WDA_LOCAL_PORT` Environment Variable and sets the `wdaLocalPort` Appium capability for iOS physical devices only.
-
-###Version 2.3.18
-
-* Updated `SelectList.define_list_elements` method to accept value for `:list_trigger` element.
-* Updated `SelectList.choose_option` to respect `:list_item` value and to click on `:list_trigger` element, if one is specified.
-* Updated `PageSection` and `PageObject` UI element object declaration methods to no longer use `class_eval` pattern.
-* Updated device profiles for iPhone 7 (iOS 10) with Chrome browser and iPad (iOS 10) with Chrome browser.
-
-###Version 2.3.17
-
-* Added `List.wait_until_item_count_is` and `List.wait_until_item_count_changes` methods.
-* `UIElement.wait_until_value_is` and `List.wait_until_item_count_is` methods now accept comparison hash.
-
-###Version 2.3.16
-
-* Added `PageSection.double_click`, `PageObject.right_click`, and `PageObject.send_keys` methods.
-
-###Version 2.3.15
-
-* Added `PageObject.wait_until_exists` and `PageObject.wait_until_gone` methods.
-
-###Version 2.3.14
-
-* Updated device profiles for iPhone 7 (iOS 10) with MS Edge browser.
-
-###Version 2.3.13
-
-* Added `AppiumServer.start`, `AppiumServer.running?`, and `AppiumServer.stop` methods for starting and stopping the Appium Server prior to executing tests on
-iOS physical devices or simulators, or Android virtual device emulators.
-
-###Version 2.3.12
-
-* Added `Environ.is_simulator?` and `Environ.is_web?` methods.
-
-###Version 2.3.11
-
-* Added support for running tests in Mobile Safari browser on physical iOS devices.
-* Updated device profiles for iPhone 7 (iOS 10) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.
-
-###Version 2.3.10
-
-* Added support for running tests in mobile Chrome or Android browsers on Android Studio virtual device emulators.
-* Added `displayed?`, `get_all_items_count`, and `get_all_list_items` methods to `PageSection` class.
-* Added `get_all_items_count`, and `get_all_list_items` methods to `List` class.
-
-###Version 2.3.9
-
-* Updated `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods to accept optional `wait_time` parameter.
-* Updated device profiles for iPhone 7 (iOS 10) with MS Edge browser, iPhone 7 (iOS 10) with Chrome browser, and iPhone 7 (iOS 10) with Firefox browser.
-* Updated device profiles for iPad (iOS 10) with Chrome browser and iPad (iOS 10) with Firefox browser.
-
-###Version 2.3.7
-
-* Added `width`, `height`, `x`, `y`, and `displayed?` methods to `UIElement` class.
-
-###Version 2.3.6
-
-* Added `TextField.clear` method for deleting the contents of text fields. This method should trigger the `onchange` event for the associated text field.
-
-###Version 2.3.5
-
-* Updated `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods to be compatible with Redactor editor fields.
-* Updated device profiles for iPhone 7 (iOS 10) with MS Edge browser, iPhone 7 (iOS 10) with Chrome browser, and iPhone 7 (iOS 10) with Firefox browser.
-
-###Version 2.3.3
-
-* Added device profile for iPhone 7 (iOS 10) with MS Edge browser.
-
-###Version 2.3.1
-
-* When testing using remotely hosted browsers on the BrowserStack service, the BrowserStack Local instance is automatically started if the `TUNNELING`
-Environment Variable is set to `true`. `Environ.tunneling` will be set to true if the BrowserStack Local instance is succesfully started.
-* Added `TestCentricity::WebDriverConnect.close_tunnel` method to close BrowserStack Local instance when Local testing is enabled. Refer to the
-**Remotely hosted desktop and mobile web browsers** section for information on usage.
-
-###Version 2.2.0
-
-* CSS selectors or XPath expressions may be used as locators for all types of **UI Elements**, including tables.
-
-###Version 2.1.10
-
-* Added device profiles for iPhone 7 (iOS 10) with Mobile Firefox browser and iPad (iOS 10) with Mobile Firefox browser.
-
-###Version 2.1.8
-
-* Added `PageSection.verify_list_items` method for **Indexed PageSection Objects**.
-
-###Version 2.1.7
-
-* Updated `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods to use backspace characters to delete contents of a textfield
-instead of using `clear`, which was preventing `onchange` JavaScript events from being triggered in some browsers.
-
-###Version 2.1.5
-
-* Added `get_min`, `get_max`, and `get_step` methods to `TextField` class.
-
-* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of `min`, `max`, and `step` attributes
-for textfields.
-
-###Version 2.1.4
-
-* Added suppression of the Info Bar that displays "Chrome is being controlled by automated test software" on locally hosted instances of the Chrome browser.
-
-
-###Version 2.1.3
-
-* Added support for "tiling" or cascading multiple browser windows when the `BROWSER_TILE` and `PARALLEL` Environment Variables are set to true. For each
-concurrent parallel thread being executed, the position of each browser will be offset by 100 pixels right and 100 pixels down. For parallel test execution,
-use the [parallel_tests gem](https://rubygems.org/gems/parallel_tests) to decrease overall test execution time.
-
-###Version 2.1.2
-
-* Added device profiles for Microsoft Lumia 950, Blackberry Leap, Blackberry Passport, and Kindle Fire HD 10
-* Added ability to set browser language support via the `LOCALE` Environment Variable for local instances of Chrome browsers
-
-###Version 2.1.0
-
-* Added device profiles for iPhone 8, iPhone 8 Plus, iPhone X devices running iOS 11
-* Added device profile for iPad Pro 10.5" with iOS 11
-* Updated iPhone 7 and iPhone 7 Plus profiles to iOS 10
-* Updated Google Pixel and Google Pixel XL profiles to Android 8
-* Added device profiles for iPhone 7 (iOS 10) with Mobile Chrome browser and iPad (iOS 10) with Mobile Chrome browser
-
-
-## What's Fixed
-###Version 2.3.19
-
-* Fixed device profile for `android_phone` - Generic Android Phone
-
-###Version 2.3.18
-
-* Fixed `SelectList.choose_option` to also accept `:text`, `:value`, and `:index` option hashes across all types of select list objects.
-
-
-###Version 2.3.15
-
-* Fixed bug in `UIElement.get_object_type` method that could result in a `NoMethodError obj not defined` error.
-* Fixed bug in `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods that failed to enqueue errors when UI elements could not be found.
-
-###Version 2.3.8
-
-* Fixed locator resolution for **Indexed PageSection Objects**.
-
-###Version 2.3.6.1
-
-* `TextField.clear` method now works with most `number` type fields.
 
-###Version 2.3.4
+A complete history of bug fixes and new features can be found in the {file:CHANGELOG.md CHANGELOG} file.
 
-* Fixed bug in `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods that prevented deletion of data in number type textfields
-and textarea controls.
+The RubyDocs for this gem can be found [here](https://www.rubydoc.info/gems/testcentricity/).
 
-###Version 2.3.3
 
-* Corrected device profiles for iPad (iOS 10) with Mobile Chrome browser and iPad (iOS 10) with Mobile Firefox browser.
+## Which gem should I use?
 
-###Version 2.2.1
+| Tested platforms                                 | TestCentricity | TestCentricity Web |
+|--------------------------------------------------|----------------|--------------------|
+| Native mobile apps only                          | Yes            | No                 |
+| Hybrid apps with WebViews only                   | Yes            | No                 |
+| Native mobile apps and desktop/mobile web        | Yes            | No                 |
+| Hybrid apps with WebViews and desktop/mobile web | Yes            | No                 |
+| Desktop/mobile web only                          | No             | Yes                |
 
-* `SelectList.choose_option` method now accepts index values for Chosen list objects.
-
-###Version 2.1.9
-
-* Fixed bug in `SelectList.choose_option`, `SelectList.get_options`, `SelectList.get_option_count`, and `SelectList.get_selected_option` methods which
-did not recognize grouped option in Chosen list objects.
-
-###Version 2.1.6
-
-* Fixed bug in `TestCentricity::WebDriverConnect.set_webdriver_path` method that was failing to set the path to the appropriate chromedriver file for OS X
-and Windows.
-
-###Version 2.1.5
-
-* Fixed Chrome and Firefox support for setting browser language via the `LOCALE` Environment Variable. This capability now works for emulated mobile
-browsers hosted in a local instance of Chrome or Firefox.
-
-###Version 2.1.0
-
-* The `TestCentricity::WebDriverConnect.initialize_web_driver` method now sets the `Environ` object to the correct device connection states for local and
-cloud hosted browsers.
-* The `TestCentricity::WebDriverConnect.initialize_web_driver` method no longer calls `initialize_browser_size` when running tests against cloud hosted
-mobile web browser, which was resulting in Appium throwing exceptions for unsupported method calls.
-* The `TestCentricity::WebDriverConnect.set_webdriver_path` method now correctly sets the path for Chrome webDrivers when the `HOST_BROWSER` Environment
-Variable is set to `chrome`. Tests against locally hosted emulated mobile web browser running on a local instance of Chrome will now work correctly.
+The TestCentricity gem is designed to support testing of native and hybrid mobile apps and/or web interfaces via desktop and
+mobile web browsers. The TestCentricity Web gem only supports testing of web interfaces via desktop and mobile web browsers.
 
 
 ## Installation
 
-Add this line to your automation project's Gemfile:
+TestCentricity version 3.0 and above requires Ruby 2.7.5 or later. To install the TestCentricity gem, add this line to your automation
+project's Gemfile:
 
-    gem 'testcentricity_web'
+    gem 'testcentricity'
 
 And then execute:
 
@@ -238,443 +68,452 @@ And then execute:
 
 Or install it yourself as:
 
-    $ gem install testcentricity_web
+    $ gem install testcentricity
 
 
 ## Setup
-###Using Cucumber
+### Using Cucumber
 
-If you are using Cucumber, you need to require the following in your *env.rb* file:
+If you are using Cucumber, you need to require the following in your `env.rb` file:
 
-    require 'capybara'
     require 'capybara/cucumber'
-    require 'testcentricity_web'
+    require 'testcentricity'
 
 
-###Using RSpec
+### Using RSpec
 
-If you are using RSpec instead, you need to require the following in your *env.rb* file:
+If you are using RSpec instead, you need to require the following in your `spec_helper.rb` file:
 
-    require 'capybara'
     require 'capybara/rspec'
-    require 'testcentricity_web'
+    require 'testcentricity'
 
 
-### Using Poltergeist
+## ScreenObjects
 
-If you will be running your tests on a "headless" web browser using Poltergeist and PhantomJS, you must add this line to your automation
-project's Gemfile:
+The **Screen Object Model** is a test automation pattern that aims to create an abstraction of your native mobile app's User
+Interface that can be used in tests. The **Screen** Object Model in native mobile test automation is equivalent to the **Page**
+Object Model in web interface test automation.
 
-    gem 'poltergeist'
+A **Screen Object** is an object that represents a single screen in your AUT (Application Under Test). **Screen Objects**
+encapsulate the implementation details of a mobile app screen and expose an API that supports interaction with, and validation
+of the UI elements on the screen.
 
-
-### Using Appium
-
-If you will be running your tests on mobile Safari browsers on simulated iOS devices using Appium and XCode Simulators, you need to require
-the following in your *env.rb* file:
-
-    require 'appium_capybara'
-
-You also need to add this line to your automation project's Gemfile:
-
-    gem 'appium_capybara'
-
-And then execute:
-
-    $ bundle
+**Screen Objects** makes it easier to maintain automated tests because changes to screen UI elements are updated in only one
+location - in the `ScreenObject` class definition. By adopting a **Screen Object Model**, Cucumber feature files and step
+definitions are no longer required to hold specific information about a screen's UI objects, thus minimizing maintenance
+requirements. If any element on, or property of a screen changes (text field attributes, button captions, element states,
+etc.), maintenance is performed in the `ScreenObject` class definition only, typically with no need to update the affected
+feature file, scenarios, or step definitions.
 
 
+### Defining a ScreenObject
 
-## Page Objects
+Your `ScreenObject` class definitions should be contained within individual `.rb` files in the `features/support/<platform>/screens`
+folder of your test automation project, where `<platform>` is typically `ios` or `android`. For each screen in your app, you will
+typically have to define two `ScreenObjects` - one for iOS and the other for Android.
 
-The **Page Object Model** is a test automation pattern that aims to create an abstraction of your web app's User Interface that can be used
-in tests. A **Page Object** is an object that represents a single page in your AUT (Application Under Test). **Page Objects** encapsulate the
-implementation details of a web page and expose an API that supports interaction with, and validation of the UI elements on the page.
+    my_automation_project
+        ├── config
+        ├── features
+        │   ├── step_definitions
+        │   ├── support
+        │   │   ├── android
+        |   |   |   └── screens
+        │   │   ├── ios
+        |   |   |   └── screens
+        │   │   ├── env.rb
+        │   │   └── hooks.rb
+        ├── Gemfile
+        └── README.md
 
-**Page Objects** makes it easier to maintain automated tests because changes to page UI elements are updated in only one location - in the
-**Page Object** class definition. By adopting a **Page Object Model**, Cucumber Feature files and step definitions are no longer required to
-hold specific information about a page's UI objects, thus minimizing maintenance requirements. If any element on a page changes (URL path,
-text field attributes, button captions, etc.), maintenance is performed in the **Page Object** class definition only, typically with no need
-to update the affected feature file, scenarios, or step definitions.
 
+You define a new `ScreenObject` as shown below:
 
-### Defining a Page Object
-
-Your **Page Object** class definitions should be contained within individual `.rb` files in the `features/support/pages` folder of your
-test automation project. You define new **Page Objects** as shown below:
-
-    class LoginPage < TestCentricity::PageObject
+    class LoginScreen < TestCentricity::ScreenObject
     end
 
 
-    class HomePage < TestCentricity::PageObject
+    class ProductsScreen < TestCentricity::ScreenObject
     end
 
 
-    class RegistrationPage < TestCentricity::PageObject
+    class CheckoutAddressScreen < TestCentricity::ScreenObject
     end
 
 
-### Adding Traits to your Page Object
+### Adding Traits to your ScreenObject
 
-Web pages typically have names and URLs associated with them. Web pages also typically have a unique object or attribute that, when present,
-indicates that the page's contents have fully loaded.
+Native app screens typically have names associated with them. Screens also typically have a unique object or attribute that, when
+present, indicates that the screen's contents have fully loaded.
 
-The `page_name` trait is registered with the **PageManager** object, which includes a `find_page` method that takes a page name as a
-parameter and returns an instance of the associated **Page Object**. If you intend to use the **PageManager**, you must define a `page_name`
-trait for each of the **Page Objects** to be registered.
+The `page_name` trait is registered with the `PageManager` object, which includes a `find_page` method that takes a page name as
+a parameter and returns an instance of the associated `ScreenObject`. If you intend to use the `PageManager`, you must define a
+`page_name` trait for each `ScreenObject` to be registered.
 
-The `page_name` trait is usually a `String` value that represents the name of the page that will be matched by the `PageManager.findpage` method.
-`page_name` traits are case and white-space sensitive. For pages that may be referenced with multiple names, the `page_name` trait may also be
-an `Array` of `String` values representing those page names.
+The `page_name` trait is usually a `String` value that represents the name of the screen that will be matched by the
+`PageManager.findpage` method. `page_name` traits are case and white-space sensitive. For screens that may be referenced with
+multiple names, the `page_name` trait may also be an `Array` of `String` values representing those screen names.
 
-A `page_url` trait should be defined if a page can be directly loaded using a URL. If you set Capybara's `app_host`, or specify a base URL
-when calling the `WebDriverConnect.initialize_web_driver` method, then your `page_url` trait can be the relative URL slug that will
-be appended to the base URL specified in `app_host`. Specifying a `page_url` trait is optional, as not all web pages can be directly loaded
-via a URL.
+The `page_locator` trait specifies a locator for unique object that exists once the screen's contents have been fully rendered. The
+`page_locator` trait is a locator strategy that uniquely identifies the object. The `ScreenObject.verify_page_exists` method
+waits for the `page_locator` trait to exist, and raises an exception if the wait time exceeds the `default_max_wait_time`.
 
-A `page_locator` trait is defined if a page has a unique object or attribute that exists once the page's contents have fully loaded. The
-`page_locator` trait is a CSS or Xpath expression that uniquely identifies the object or attribute. The `verify_page_exists` method waits
-for the `page_locator` trait to exist.
+A `page_url` trait should be defined if a screen can be directly loaded using a deep link. Specifying a `page_url` trait is optional,
+as not all screens can be directly accessed via a deep link.
 
-You define your page's **Traits** as shown below:
+You define your screen's **Traits** as shown below:
 
-    class LoginPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Login' }
-      trait(:page_url)        { '/sign_in' }
-      trait(:page_locator)    { 'body.login-body' }
+    class LoginScreen < TestCentricity::ScreenObject
+      trait(:page_name)    { 'Login' }
+      trait(:page_locator) { { accessibility_id: 'login screen' } }
+      trait(:page_url)     { 'login' }
     end
 
 
-    class HomePage < TestCentricity::PageObject
-      # this page may be referred to as 'Home' or 'Dashboard' page so page_name trait is an Array of Strings
-      trait(:page_name)       { ['Home', 'Dashboard'] }
-      trait(:page_url)        { '/dashboard' }
-      trait(:page_locator)    { 'body.dashboard' }
+    class ProductsScreen < TestCentricity::ScreenObject
+      trait(:page_name)    { 'Products' }
+      trait(:page_locator) { { accessibility_id: 'products screen' } }
+      trait(:page_url)     { 'store-overview' }
     end
 
 
-    class RegistrationPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Registration' }
-      trait(:page_url)        { '/register' }
-      trait(:page_locator)    { 'body.registration' }
+    class CheckoutAddressScreen < TestCentricity::ScreenObject
+      trait(:page_name)    { 'Checkout - Address' }
+      trait(:page_locator) { { accessibility_id: 'checkout address screen' } }
+      trait(:page_url)     { 'checkout-address' }
     end
 
 
-### Adding UI Elements to your Page Object
+### Adding UI Elements to your ScreenObject
 
-Web pages are made up of UI elements like text fields, check boxes, combo boxes, radio buttons, tables, lists, buttons, etc.
-**UI Elements** are added to your **Page Object** class definition as shown below:
+Native app screens are made up of UI elements like text fields, check boxes, switches, lists, buttons, etc. **UI Elements** are
+added to your `ScreenObject` class definition as shown below:
 
-    class LoginPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Login' }
-      trait(:page_url)        { '/sign_in' }
-      trait(:page_locator)    { 'body.login-body' }
-    
-      # Login page UI elements
-      textfield :user_id_field,       'input#userName'
-      textfield :password_field,      'input#password'
-      button    :login_button,        'button#login'
-      checkbox  :remember_checkbox,   'input#rememberUser'
-      label     :error_message_label, 'div#statusBar.login-error'
+    class LoginScreen < TestCentricity::ScreenObject
+      trait(:page_name)    { 'Login' }
+      trait(:page_locator) { { accessibility_id: 'login screen' } }
+      trait(:page_url)     { 'login' }
+      
+      # Login screen UI elements
+      labels     username_label: { accessibility_id: 'Username'},
+                 password_label: { xpath: '(//XCUIElementTypeStaticText[@name="Password"])[1]'},
+                 username_error: { accessibility_id: 'Username-error-message' },
+                 password_error: { accessibility_id: 'Password-error-message' },
+                 generic_error:  { accessibility_id: 'generic-error-message' }
+      textfields username_field: { accessibility_id: 'Username input field' },
+                 password_field: { accessibility_id: 'Password input field' }
+      button     :login_button,  { accessibility_id: 'Login button' }
     end
-    
 
-    class RegistrationPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Registration' }
-      trait(:page_url)        { '/register' }
-      trait(:page_locator)    { 'body.registration' }
-     
-      # Registration page UI elements
-      textfields  first_name_field:    'input#firstName',
-                  last_name_field:     'input#lastName',
-                  email_field:         'input#email',
-                  phone_number_field:  'input#phone',
-                  address_field:       'input#streetAddress',
-                  city_field:          'input#city',
-                  post_code_field:     'input#postalCode',
-                  password_field:      'input#password',
-                  pword_confirm_field: 'input#passwordConfirmation'
-      selectlists title_select:        'select#title',
-                  gender_select:       'select#gender',
-                  state_select:        'select#stateProvince'
-      checkbox    :email_opt_in_check, 'input#marketingEmailsOptIn'
-      button      :sign_up_button,     'button#registrationSignUp'
-    end
 
+    class CheckoutAddressScreen < TestCentricity::ScreenObject
+      trait(:page_name)    { 'Checkout - Address' }
+      trait(:page_locator) { { accessibility_id: 'checkout address screen' } }
+      trait(:page_url)     { 'checkout-address' }
+      
+      # Checkout Address screen UI elements
+      textfields fullname_field:     { accessibility_id: 'Full Name* input field' },
+                 address1_field:     { accessibility_id: 'Address Line 1* input field' },
+                 address2_field:     { accessibility_id: 'Address Line 2 input field' },
+                 city_field:         { accessibility_id: 'City* input field' },
+                 state_region_field: { accessibility_id: 'State/Region input field' },
+                 zip_code_field:     { accessibility_id: 'Zip Code* input field' },
+                 country_field:      { accessibility_id: 'Country* input field' }
+      button     :to_payment_button, { accessibility_id: 'To Payment button' }
+    end
 
-### Adding Methods to your Page Object
 
-It is good practice for your Cucumber step definitions to call high level methods in your your **Page Object** instead of directly accessing
-and interacting with a page object's UI elements. You can add high level methods to your **Page Object** class definition for interacting with
-the UI to hide implementation details, as shown below:
+### Adding Methods to your ScreenObject
 
-    class LoginPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Login' }
-      trait(:page_url)        { '/sign_in' }
-      trait(:page_locator)    { 'body.login-body' }
-    
-      # Login page UI elements
-      textfield :user_id_field,        'input#userName'
-      textfield :password_field,       'input#password'
-      button    :login_button,         'button#login'
-      checkbox  :remember_checkbox,    'input#rememberUser'
-      label     :error_message_label,  'div#statusBar.login-error'
-      link      :forgot_password_link, 'a.forgotPassword'
-    
-      # log in to web app
-      def login(user_id, password)
-        user_id_field.set(user_id)
-        password_field.set(password)
-        login_button.click
-      end
+It is good practice for your Cucumber step definitions to call high level methods in your your `ScreenObject` instead of
+directly accessing and interacting with a screen object's UI elements. You can add high level methods to your `ScreenObject`
+class definition for interacting with the UI to hide implementation details, as shown below:
 
-      def remember_me(state)
-        remember_checkbox.set_checkbox_state(state)
-      end
+    class LoginScreen < TestCentricity::ScreenObject
+      trait(:page_name)    { 'Login' }
+      trait(:page_locator) { { accessibility_id: 'login screen' } }
+      trait(:page_url)     { 'login' }
+      
+      # Login screen UI elements
+      labels     username_label: { accessibility_id: 'Username'},
+                 password_label: { xpath: '(//XCUIElementTypeStaticText[@name="Password"])[1]'},
+                 username_error: { accessibility_id: 'Username-error-message' },
+                 password_error: { accessibility_id: 'Password-error-message' },
+                 generic_error:  { accessibility_id: 'generic-error-message' }
+      textfields username_field: { accessibility_id: 'Username input field' },
+                 password_field: { accessibility_id: 'Password input field' }
+      button     :login_button,  { accessibility_id: 'Login button' }
 
-      # verify Login page default UI state
       def verify_page_ui
+        super
         ui = {
-            login_button         => { :visible => true, :caption => 'LOGIN' },
-            user_id_field        => { :visible => true, :enabled => true },
-            password_field       => { :visible => true, :enabled => true, :value => '', :placeholder => 'Password' },
-            remember_checkbox    => { :exists  => true, :enabled => true, :checked => false },
-            forgot_password_link => { :visible => true, :caption => 'Forgot your password?' },
-            error_message_label  => { :visible => false }
-            }
+          header_label   => { visible: true, caption: 'Login' },
+          username_label => { visible: true, caption: 'Username' },
+          username_field => { visible: true, enabled: true },
+          password_label => { visible: true, caption: 'Password' },
+          password_field => { visible: true, enabled: true },
+          login_button   => { visible: true, enabled: true, caption: 'Login' }
+        }
         verify_ui_states(ui)
-        super
       end
-    end
-        
-
-    class RegistrationPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Registration' }
-      trait(:page_url)        { '/register' }
-      trait(:page_locator)    { 'body.registration' }
-     
-      # Registration page UI elements
-      textfields  first_name_field:    'input#firstName',
-                  last_name_field:     'input#lastName',
-                  email_field:         'input#email',
-                  phone_number_field:  'input#phone',
-                  address_field:       'input#streetAddress',
-                  city_field:          'input#city',
-                  post_code_field:     'input#postalCode',
-                  password_field:      'input#password',
-                  pword_confirm_field: 'input#passwordConfirmation'
-      selectlists title_select:        'select#title',
-                  gender_select:       'select#gender',
-                  state_select:        'select#stateProvince'
-      checkbox    :email_opt_in_check, 'input#marketingEmailsOptIn'
-      button      :sign_up_button,     'button#registrationSignUp'
       
-      # populate Registration page fields with profile data
-      def enter_profile_data(profile)
-        fields = { title_select        => profile.title,
-                   first_name_field    => profile.first_name,
-                   last_name_field     => profile.last_name,
-                   gender_select       => profile.gender,
-                   phone_number_field  => profile.phone,
-                   email_field         => profile.email,
-                   address_field       => profile.address,
-                   city_field          => profile.city,
-                   state_select        => profile.state,
-                   post_code_field     => profile.postal_code,
-                   password_field      => profile.password,
-                   pword_confirm_field => profile.confirm_password
-          }
+      def login(username, password)
+        fields = {
+          username_field => username,
+          password_field => password
+        }
         populate_data_fields(fields)
-        sign_up_button.click
+        login_button.tap
+      end
+      
+      def verify_entry_error(reason)
+        ui = case reason.gsub(/\s+/, '_').downcase.to_sym
+             when :invalid_password, :invalid_user
+               { generic_error => { visible: true, caption: 'Provided credentials do not match any user in this service.' } }
+             when :locked_account
+               { generic_error => { visible: true, caption: 'Sorry, this user has been locked out.' } }
+             when :no_username
+               { username_error => { visible: true, caption: 'Username is required' } }
+             when :no_password
+               { password_error => { visible: true, caption: 'Password is required' } }
+             else
+               raise "#{reason} is not a valid selector"
+             end
+        verify_ui_states(ui)
       end
     end
 
 
 
-Once your **Page Objects** have been instantiated, you can call your methods as shown below:
+Once your `ScreenObject` has been instantiated, you can call your methods as shown below:
+
+    login_screen.login('snicklefritz', 'Pa55w0rd')
+    login_screen.verify_entry_error('invalid user')
 
-    login_page.remember_me(true)
-    login_page.user_id_field.set('snicklefritz', 'Pa55w0rd')
-    
 
+## ScreenSections
 
-## PageSection Objects
+A `ScreenSection` is a collection of **UI Elements** that may appear in multiple locations on a screen, or on multiple screens 
+in an app. It is a collection of **UI Elements** that represent a conceptual area of functionality, like a navigation bar, a
+search capability, or a menu. **UI Elements** and functional behavior are confined to the scope of a `ScreenSection` object.
 
-A **PageSection Object** is a collection of **UI Elements** that may appear in multiple locations on a page, or on multiple pages in a web
-app. It is a collection of **UI Elements** that represent a conceptual area of functionality, like a navigation bar, a search capability,
-or a menu. **UI Elements** and functional behavior are confined to the scope of a **PageSection Object**.
+A `ScreenSection` may contain other `ScreenSection` objects.
 
-A **PageSection Object** may contain other **PageSection Objects**.
 
+### Defining a ScreenSection
 
-### Defining a PageSection Object
+Your `ScreenSection` class definitions should be contained within individual `.rb` files in the `features/support/<platform>/sections`
+folder of your test automation project, where `<platform>` is typically `ios` or `android`. For each screen section in your app,
+you will typically have to define two `ScreenSections` - one for iOS and the other for Android.
 
-Your **PageSection** class definitions should be contained within individual `.rb` files in the `features/support/sections` folder of
-your test automation project. You define new **PageSection Objects** as shown below:
+    my_automation_project
+        ├── config
+        ├── features
+        │   ├── step_definitions
+        │   ├── support
+        │   │   ├── android
+        |   |   |   ├── screens
+        |   |   |   └── sections
+        │   │   ├── ios
+        |   |   |   ├── screens
+        |   |   |   └── sections
+        │   │   ├── env.rb
+        │   │   └── hooks.rb
+        ├── Gemfile
+        └── README.md
 
-    class SearchForm < TestCentricity::PageSection
+
+You define a new `ScreenSection` as shown below:
+
+    class NavMenu < TestCentricity::ScreenSection
     end
 
 
-### Adding Traits to a PageSection Object
+### Adding Traits to a ScreenSection
 
-A **PageSection Object** typically has a root node object that encapsulates a collection of **UI Elements**. The `section_locator` trait
+A `ScreenSection` typically has a root node object that encapsulates a collection of `UIElements`. The `section_locator` trait
 specifies the CSS or Xpath expression that uniquely identifies that root node object.
 
-You define your page section's **Traits** as shown below:
+You define your section's **Traits** as shown below:
 
-    class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)   { 'form#gnav-search' }
-      trait(:section_name)      { 'Search widget' }
+    class NavMenu < TestCentricity::ScreenSection
+      trait(:section_name)    { 'Nav Menu' }
+      trait(:section_locator) { { xpath: '//XCUIElementTypeScrollView' } }
     end
 
 
-### Adding UI Elements to your PageSection Object
+### Adding UI Elements to your ScreenSection
+
+A `ScreenSection` is typically made up of UI elements like text fields, check boxes, switches, lists, buttons, etc. **UI Elements**
+are added to your `ScreenSection` class definition as shown below:
+
+    class NavMenu < TestCentricity::ScreenSection
+      trait(:section_name)    { 'Nav Menu' }
+      trait(:section_locator) { { xpath: '//XCUIElementTypeScrollView' } }
+
+      # Nav Menu UI elements
+      buttons close_button:        { accessibility_id: 'close menu' },
+              webview_button:      { accessibility_id: 'menu item webview' },
+              qr_code_button:      { accessibility_id: 'menu item qr code scanner' },
+              geo_location_button: { accessibility_id: 'menu item geo location' },
+              drawing_button:      { accessibility_id: 'menu item drawing' },
+              report_a_bug_button: { accessibility_id: 'menu item report a bug' },
+              about_button:        { accessibility_id: 'menu item about' },
+              reset_app_button:    { accessibility_id: 'menu item reset app' },
+              biometrics_button:   { accessibility_id: 'menu item biometrics' },
+              log_in_button:       { accessibility_id: 'menu item log in' },
+              log_out_button:      { accessibility_id: 'menu item log out' },
+              api_calls_button:    { accessibility_id: 'menu item api calls' },
+              sauce_video_button:  { accessibility_id: 'menu item sauce bot video' }
+    end
 
-Page sections are typically made up of UI elements like text fields, check boxes, combo boxes, radio buttons, tables, lists, buttons, etc.
-**UI Elements** are added to your **PageSection** class definition as shown below:
 
-    class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)   { 'form#gnav-search' }
-      trait(:section_name)      { 'Search widget' }
-        
-      # Search Form UI elements
-      textfield :search_field,  'input#search-query'
-      button    :search_button, 'button[type=submit]'
-    end
+### Adding Methods to your ScreenSection
 
+You can add methods to your `ScreenSection` class definition, as shown below:
 
-### Adding Methods to your PageSection Object
+    class NavMenu < TestCentricity::ScreenSection
+      trait(:section_name)    { 'Nav Menu' }
+      trait(:section_locator) { { xpath: '//XCUIElementTypeScrollView' } }
 
-You can add high level methods to your **PageSection** class definition, as shown below:
+      # Nav Menu UI elements
+      buttons close_button:        { accessibility_id: 'close menu' },
+              webview_button:      { accessibility_id: 'menu item webview' },
+              qr_code_button:      { accessibility_id: 'menu item qr code scanner' },
+              geo_location_button: { accessibility_id: 'menu item geo location' },
+              drawing_button:      { accessibility_id: 'menu item drawing' },
+              report_a_bug_button: { accessibility_id: 'menu item report a bug' },
+              about_button:        { accessibility_id: 'menu item about' },
+              reset_app_button:    { accessibility_id: 'menu item reset app' },
+              biometrics_button:   { accessibility_id: 'menu item biometrics' },
+              log_in_button:       { accessibility_id: 'menu item log in' },
+              log_out_button:      { accessibility_id: 'menu item log out' },
+              api_calls_button:    { accessibility_id: 'menu item api calls' },
+              sauce_video_button:  { accessibility_id: 'menu item sauce bot video' }
 
-    class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)   { 'form#gnav-search' }
-      trait(:section_name)      { 'Search widget' }
-        
-      # Search Form UI elements
-      textfield :search_field,  'input#search-query'
-      button    :search_button, 'button[type=submit]'
+      def verify_ui
+        ui = {
+          self                => { visible: true },
+          close_button        => { visible: true, enabled: true },
+          webview_button      => { visible: true, enabled: true, caption: 'Webview' },
+          qr_code_button      => { visible: true, enabled: true, caption: 'QR Code Scanner' },
+          geo_location_button => { visible: true, enabled: true, caption: 'Geo Location' },
+          drawing_button      => { visible: true, enabled: true, caption: 'Drawing' },
+          report_a_bug_button => { visible: true, enabled: true, caption: 'Report A Bug' },
+          about_button        => { visible: true, enabled: true, caption: 'About' },
+          reset_app_button    => { visible: true, enabled: true, caption: 'Reset App State' },
+          biometrics_button   => { visible: true, enabled: true, caption: 'FaceID' },
+          log_in_button       => { visible: true, enabled: true, caption: 'Log In' },
+          log_out_button      => { visible: true, enabled: true, caption: 'Log Out' },
+          api_calls_button    => { visible: true, enabled: true, caption: 'Api Calls' },
+          sauce_video_button  => { visible: true, enabled: true, caption: 'Sauce Bot Video' }
+        }
+        verify_ui_states(ui)
+      end
 
-      def search_for(value)
-        search_field.set(value)
-        search_button.click
+      def close
+        close_button.click
+        self.wait_until_hidden(3)
+      end
+
+      def verify_closed
+        verify_ui_states(close_button => { visible: false })
       end
     end
 
 
-### Adding PageSection Objects to your Page Object
+### Adding ScreenSections to your ScreenObject
 
-You add a **PageSection Object** to its associated **Page Object** as shown below:
+You add a `ScreenSection` to its associated `ScreenObject` as shown below:
 
-    class HomePage < TestCentricity::PageObject
-      trait(:page_name)       { 'Home' }
-      trait(:page_url)        { '/dashboard' }
-      trait(:page_locator)    { 'body.dashboard' }
-      
-      # Home page Section Objects
-      section :search_form, SearchForm
+    class BaseAppScreen < TestCentricity::ScreenObject
+      # Base App screen UI elements
+      label    :header_label, { accessibility_id: 'container header' }
+      sections nav_bar:  NavBar,
+               nav_menu: NavMenu
     end
 
-Once your **Page Object** has been instantiated, you can call its **PageSection** methods as shown below:
+Once your `ScreenObject` has been instantiated, you can call its `ScreenSection` methods as shown below:
 
-    home_page.search_form.search_for('ocarina')
-    
-    
+    base_screen.nav_menu.verify_ui
 
-## UI Elements
 
-**Page Objects** and **PageSection Objects** are typically made up of **UI Element** like text fields, check boxes, combo boxes, radio buttons,
-tables, lists, buttons, etc. **UI Elements** are declared and instantiated within the class definition of the **Page Object** or **PageSection
-Object** in which they are contained. With TestCentricity Web, all UI elements are based on the **UIElement** class.
+## AppUIElements
 
+Native app `ScreenObjects` and `ScreenSections` are typically made up of **UI Element** like text fields, switches, lists,
+buttons, etc. **UI Elements** are declared and instantiated within the class definition of the `ScreenObject` or `ScreenSection`
+in which they are contained. With TestCentricity, all native app screen UI elements are based on the `AppUIElement` class.
 
-### Declaring and Instantiating UI Element
 
-Single **UIElement** declarations have the following format:
-                                     
-    elementType :element Name, locator
+### Declaring and Instantiating AppUIElements
 
-* The `element name` is the unique name that you will use to refer to the UI element and is specified as a symbol.
-* The `locator` is the CSS or XPath attribute that uniquely and unambiguously identifies the UI element.
+Single `AppUIElement` declarations have the following format:
 
-Multiple **UIElement** declarations for a collection of elements of the same type can be performed by passing a hash table containing the
-names and locators of each individual element.
+    elementType :elementName, { locator_strategy, locator_identifier }
 
-### Example UI Element Declarations
+* The `elementName` is the unique name that you will use to refer to the UI element and is specified as a `Symbol`.
+* The `locator_strategy` specifies the [selector strategy](https://appium.io/docs/en/commands/element/find-elements/index.html#selector-strategies) 
+that Appium will use to find the `AppUIElement`. Valid selectors are `accessibility_id:`, `id:`, `name:`, `class:`, `xpath:`, 
+`predicate:` (iOS only), `class_chain:` (iOS only), and `css:` (WebViews in hybrid apps only).
+* The `locator_identifier` is the value or attribute that uniquely and unambiguously identifies the `AppUIElement`.
 
-Supported **UI Element** elementTypes and their declarations have the following format:
+Multiple `AppUIElement` declarations for a collection of elements of the same type can be performed by passing a hash table
+containing the names and locators of each individual element.
+
+### Example AppUIElement Declarations
+
+Supported `AppUIElement` elementTypes and their declarations have the following format:
 
 *Single element declarations:*
 
-    class SamplePage < TestCentricity::PageObject
-
-      button      :button_name, locator
-      textfield   :field_name, locator
-      checkbox    :checkbox_name, locator
-      radio       :radio_button_name, locator
-      label       :label_name, locator
-      link        :link_name, locator
-      selectlist  :select_name, locator
-      list        :list_name, locator
-      table       :table_name, locator
-      image       :image_name, locator
-      filefield   :filefield_name, locator
-      
+    class SampleScreen < TestCentricity::ScreenObject
+      button     :button_name, { locator_strategy, locator_identifier }
+      textfield  :field_name, { locator_strategy, locator_identifier }
+      checkbox   :checkbox_name, { locator_strategy, locator_identifier }
+      label      :label_name, { locator_strategy, locator_identifier }
+      selectlist :select_name, { locator_strategy, locator_identifier }
+      list       :list_name, { locator_strategy, locator_identifier }
+      image      :image_name, { locator_strategy, locator_identifier }
+      switch     :switch_name, { locator_strategy, locator_identifier }
+      element    :element_name, { locator_strategy, locator_identifier }
+      alert      :alert_name, { locator_strategy, locator_identifier }
     end
- 
+
 *Multiple element declarations:*
 
-    class SamplePage < TestCentricity::PageObject
-  
-      buttons      button_1_name: locator,
-                   button_2_name: locator,
-                   button_X_name: locator
-      textfields   field_1_name: locator,
-                   field_2_name: locator,
-                   field_X_name: locator
-      checkboxes   check_1_name: locator,
-                   check_2_name: locator,
-                   check_X_name: locator
-      radios       radio_1_name: locator,
-                   radio_X_name: locator
-      labels       label_1_name: locator,
-                   label_X_name: locator
-      links        link_1_name: locator,
-                   link_X_name: locator
-      selectlists  selectlist_1_name: locator,
-                   selectlist_X_name: locator
-      lists        list_1_name: locator,
-                   list_X_name: locator
-      tables       table_1_name: locator,
-                   table_X_name: locator
-      images       image_1_name: locator,
-                   image_X_name: locator
-      filefields   filefield_1_name: locator,
-                   filefield_X_name: locator
-                   
+    class SampleScreen < TestCentricity::ScreenObject
+      buttons    button_1_name: { locator_strategy, locator_identifier },
+                 button_2_name: { locator_strategy, locator_identifier },
+                 button_X_name: { locator_strategy, locator_identifier }
+      textfields field_1_name: { locator_strategy, locator_identifier },
+                 field_2_name: { locator_strategy, locator_identifier },
+                 field_X_name: { locator_strategy, locator_identifier }
+      checkboxes check_1_name: { locator_strategy, locator_identifier },
+                 check_2_name: { locator_strategy, locator_identifier },
+                 check_X_name: { locator_strategy, locator_identifier }
+      labels     label_1_name: { locator_strategy, locator_identifier },
+                 label_X_name: { locator_strategy, locator_identifier }
+      images     image_1_name: { locator_strategy, locator_identifier },
+                 image_X_name: { locator_strategy, locator_identifier }
     end
 
-
-Refer to the Class List documentation for the **PageObject** and **PageSection** classes for details on the class methods used for declaring
-and instantiating **UI Elements**. Examples of UI element declarations can be found in the ***Adding UI Elements to your Page Object*** and
-***Adding UI Elements to your PageSection Object*** sections above.
+Refer to the Class List documentation for the `ScreenObject` and `ScreenSection` classes for details on the class methods used
+for declaring and instantiating `AppUIElements`. Examples of UI element declarations can be found in the ***Adding UI Elements
+to your ScreenObject*** and ***Adding UI Elements to your ScreenSection*** sections above.
 
 
-### UIElement Inherited Methods
+### AppUIElement Inherited Methods
 
-With TestCentricity, all UI elements are based on the **UIElement** class, and inherit the following methods:
+With TestCentricity, all native app UI elements are based on the `AppUIElement` class, and inherit the following methods:
 
 **Action methods:**
 
     element.click
-    element.double_click
-    element.right_click
-    element.click_at(x, y)
-    element.hover
-    element.drag_by(right_offset, down_offset)
-    element.drag_and_drop(target, right_offset, down_offset)
+    element.tap
+    element.double_tap
+    element.hover_at(x, y)
+    element.scroll(direction)
+    element.swipe(direction)
 
 **Object state methods:**
 
@@ -683,15 +522,14 @@ With TestCentricity, all UI elements are based on the **UIElement** class, and i
     element.hidden?
     element.enabled?
     element.disabled?
-    element.displayed?
-    element.get_value
+    element.selected?
+    element.tag_name
     element.width
     element.height
-    element.x
-    element.y
+    element.x_loc
+    element.y_loc
     element.get_attribute(attrib)
-    element.get_native_attribute(attrib)
-    
+
 **Waiting methods:**
 
     element.wait_until_exists(seconds)
@@ -702,79 +540,260 @@ With TestCentricity, all UI elements are based on the **UIElement** class, and i
     element.wait_until_value_changes(seconds)
 
 
-## Instantiating your Page Objects
+### Populating your ScreenObject or ScreenSection with data
 
-Before you can call the methods in your **Page Objects** and **PageSection Objects**, you must instantiate the **Page Objects** of your
-web application, as well as create instance variables which can be used when calling a **Page Objects** methods from your step definitions.
-There are several ways to instantiate your **Page Objects**.
+A typical automated test may be required to perform the entry of test data by interacting with various `AppUIElements` on your
+`ScreenObject` or `ScreenSection`. This data entry can be performed using the various object action methods (listed above) for
+each `AppUIElement` that needs to be interacted with.
 
-One common implementation is shown below:
+The `ScreenObject.populate_data_fields` and `ScreenSection.populate_data_fields` methods support the entry of test data into a
+collection of `AppUIElements`. The `populate_data_fields` method accepts a hash containing key/hash pairs of `AppUIElements`
+and their associated data to be entered. Data values must be in the form of a `String` for `textfield` controls. For `checkbox`
+controls, data must either be a `Boolean` or a `String` that evaluates to a `Boolean` value (Yes, No, 1, 0, true, false).
 
-    module WorldPages
-      def login_page
-        @login_page ||= LoginPage.new
-      end
-    
-      def home_page
-        @home_page ||= HomePage.new
-      end
-    
-      def registration_page
-        @registration_page ||= RegistrationPage.new
-      end
-    
-      def search_results_page
-        @search_results_page ||= SearchResultsPage.new
-      end
+The `populate_data_fields` method verifies that data attributes associated with each `AppUIElement` is not `nil` or `empty`
+before attempting to enter data into the `AppUIElement`.
+
+The optional `wait_time` parameter is used to specify the time (in seconds) to wait for each `AppUIElement` to become viable
+for data entry (the `AppUIElement` must be visible and enabled) before entering the associated data value. This option is
+useful in situations where entering data, or setting the state of a `AppUIElement` might cause other `AppUIElements` to become
+visible or active. Specifying a wait_time value ensures that the subsequent `AppUIElements` will be ready to be interacted with
+as states are changed. If the wait time is `nil`, then the wait time will be 5 seconds.
+
+    def enter_data(user_data)
+      fields = {
+        first_name_field   => user_data.first_name,
+        last_name_field    => user_data.last_name,
+        email_field        => user_data.email,
+        phone_number_field => user_data.phone_number
+      }
+      populate_data_fields(fields, wait_time = 2)
     end
-        
-    World(WorldPages)
 
-The `WorldPages` module above can be defined in your `env.rb` file, or you can define it in a separate `world_pages.rb` file in the
-`features/support` folder.
 
-While this approach is effective for small web applications with only a few pages (and hence few **Page Objects**), it quickly becomes
-cumbersome to manage if your web application has dozens of **Page Objects** that need to be instantiated and managed.
+### Verifying AppUIElements on your ScreenObject or ScreenSection
 
-### Using the PageManager
+A typical automated test executes one or more interactions with the user interface, and then performs a validation to verify
+whether the expected state of the UI has been achieved. This verification can be performed using the various object state methods
+(listed above) for each `AppUIElement` that requires verification. Depending on the complexity and number of `AppUIElements` to
+be verified, the code required to verify the presence of `AppUIElements` and their correct states can become cumbersome.
+
+The `ScreenObject.verify_ui_states` and `ScreenSection.verify_ui_states` methods support the verification of multiple properties
+of multiple UI elements on a `ScreenObject` or `ScreenSection`. The `verify_ui_states` method accepts a hash containing key/hash
+pairs of UI elements and their properties or attributes to be verified.
+
+     ui = {
+       object1 => { property: state },
+       object2 => { property: state, property: state },
+       object3 => { property: state }
+     }
+     verify_ui_states(ui)
+
+The `verify_ui_states` method queues up any exceptions that occur while verifying each object's properties until all `AppUIElements`
+and their properties have been checked, and then posts any exceptions encountered upon completion. Posted exceptions include a
+screenshot of the screen where expected results did not match actual results.
+
+The `verify_ui_states` method supports the following property/state pairs:
+
+**All Objects:**
+
+    :exists            Boolean
+    :enabled           Boolean
+    :disabled          Boolean
+    :visible           Boolean
+    :hidden            Boolean
+    :width             Integer
+    :height            Integer
+    :x                 Integer
+    :y                 Integer
+    :class             String
+    :value or :caption String
+    :attribute         Hash
+
+**Text Fields:**
+
+    :placeholder String
+    :readonly    Boolean  (WebViews only)
+    :maxlength   Integer  (WebViews only)
+
+**Checkboxes:**
+
+    :checked Boolean
+
+#### Comparison States
+
+The `verify_ui_states` method supports comparison states using property/comparison state pairs:
+
+    object => { property: { comparison_state: value } }
+
+Comparison States:
+
+    :lt or :less_than                  Integer or String
+    :lt_eq or :less_than_or_equal      Integer or String
+    :gt or :greater_than               Integer or String
+    :gt_eq or :greater_than_or_equal   Integer or String
+    :starts_with                       String
+    :ends_with                         String
+    :contains                          String
+    :not_contains or :does_not_contain Integer or String
+    :not_equal                         Integer, String, or Boolean
+
+
+#### I18n Translation Validation
+
+The `verify_ui_states` method also supports I18n string translations using property/I18n key name pairs:
+
+    object => { property: { translate_key: 'name of key in I18n compatible .yml file' } }
+
+**I18n Translation Keys:**
+
+    :translate            String
+    :translate_upcase     String
+    :translate_downcase   String
+    :translate_capitalize String
+    :translate_titlecase  String
+
+The example below depicts the usage of the `verify_ui_states` method to verify that the captions for menu items are correctly
+translated.
+
+    def verify_menu
+      ui = {
+        account_settings_item => { visible: true, caption: { translate: 'Header.settings.account' } },
+        help_item             => { visible: true, caption: { translate: 'Header.settings.help' } },
+        feedback_item         => { visible: true, caption: { translate: 'Header.settings.feedback' } },
+        legal_item            => { visible: true, caption: { translate: 'Header.settings.legal' } },
+        institution_item      => { visible: true, caption: { translate: 'Header.settings.institution' } },
+        configurations_item   => { visible: true, caption: { translate: 'Header.settings.configurations' } },
+        contact_us_item       => { visible: true, caption: { translate: 'Header.settings.contact' } },
+        downloads_item        => { visible: true, caption: { translate: 'Header.settings.downloads' } }
+      }
+      verify_ui_states(ui)
+    end
+
+Each supported language/locale combination has a corresponding `.yml` file. I18n `.yml` file naming convention uses
+[ISO-639 language codes and ISO-3166 country codes](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html).
+For example:
+
+| Language (Country)    | File name |
+|-----------------------|-----------|
+| English               | en.yml    |
+| English (Canada)      | en-CA.yml |
+| French (Canada)       | fr-CA.yml |
+| French                | fr.yml    |
+| Spanish               | es.yml    |
+| German                | de.yml    |
+| Portuguese (Brazil)   | pt-BR.yml |
+| Portuguese (Portugal) | pt-PT.yml |
+
+I18n `.yml` files contain key/value pairs representing the name of a translated string (key) and the string value.
+
+Baseline translation strings are stored in `.yml` files in the `config/locales/` folder.
+
+    my_automation_project
+        ├── config
+        │   ├── locales
+        │   │   ├── en.yml
+        │   │   ├── es.yml
+        │   │   ├── fr.yml
+        │   │   ├── fr-CA.yml
+        │   │   └── en-AU.yml
+        │   ├── test_data
+        │   └── cucumber.yml
+        ├── features
+        ├── Gemfile
+        └── README.md
+
+
+## Instantiating ScreenObjects and Utilizing the PageManager
+
+Before you can call the methods in your `ScreenObjects` and `ScreenSections`, you must instantiate the `ScreenObjects` of your
+native mobile application, as well as create instance variables which can be used when calling `ScreenObject` methods from
+your step definitions or specs.
+
+The `PageManager` class provides methods for supporting the instantiation and management of `ScreenObjects` and `PageObjects`.
+In the code example below, the `page_objects` method contains a hash table of your `ScreenObject` instances and their associated
+`ScreenObject` classes to be instantiated by `PageManager`:
 
-The **PageManager** class provides methods for supporting the instantiation and management of **Page Objects**. In the code example below,
-the `page_objects` method contains a hash table of your **Page Object** instances and their associated **Page Object** class names
-to be instantiated by **PageManager**:
-    
     module WorldPages
       def page_objects
-        { :login_page                => LoginPage,
-          :home_page                 => HomePage,
-          :registration_page         => RegistrationPage,
-          :search_results_page       => SearchResultsPage,
-          :products_grid_page        => ProductsCollectionPage,
-          :product_detail_page       => ProductDetailPage,
-          :shopping_basket_page      => ShoppingBasketPage,
-          :payment_method_page       => PaymentMethodPage,
-          :confirm_purchase_page     => PurchaseConfirmationPage,
-          :my_account_page           => MyAccountPage,
-          :my_order_history_page     => MyOrderHistoryPage,
-          :my_ship_to_addresses_page => MyShipToAddressesPage,
-          :terms_conditions_page     => TermsConditionsPage,
-          :privacy_policy_page       => PrivacyPolicyPage,
-          :faqs_page                 => FAQsPage,
-          :contact_us_page           => ContactUsPage
+        {
+          login_screen:            LoginScreen,
+          registration_screen:     RegistrationScreen,
+          search_results_screen:   SearchResultsScreen,
+          products_grid_screen:    ProductsCollectionScreen,
+          product_detail_screen:   ProductDetailScreen,
+          shopping_basket_screen:  ShoppingBasketScreen,
+          payment_method_screen:   PaymentMethodScreen,
+          confirm_purchase_screen: PurchaseConfirmationScreen,
+          my_account_screen:       MyAccountScreen,
+          my_order_history_screen: MyOrderHistoryScreen
         }
       end
     end
     
     World(WorldPages)
-    
+
+
 The `WorldPages` module above should be defined in the `world_pages.rb` file in the `features/support` folder.
 
-Include the code below in your `env.rb` file to ensure that your **Page Objects** are instantiated before your Cucumber scenarios are
-executed:
-    
+Include the code below in your `env.rb` file to ensure that your `ScreenObjects` are instantiated before your Cucumber scenarios
+are executed:
+
     include WorldPages
     WorldPages.instantiate_page_objects
-    
-**NOTE:** If you intend to use the **PageManager**, you must define a `page_name` trait for each of the **Page Objects** to be registered.
+
+**NOTE:** If you intend to use the `PageManager`, you must define a `page_name` trait for each of the `ScreenObjects` to be registered.
+
+
+### Instantiating ScreenObjects and PageObjects for a combined native iOS/Android app and web app
+
+If your native mobile apps share feature parity with a responsive desktop/mobile web UI, you can define iOS and Android specific
+`ScreenObjects` and the corresponding web specific `PageObjects`. If you use the `PLATFORM` Environment Variable to specify the target
+test platform (`ios`, `android`, or `web`) at test run time, the following implementation of the `page_objects` method will ensure
+instantiation of the correct `ScreenObjects` or `PageObjects` at run time:
+
+    module WorldPages
+      def page_objects
+        case ENV['PLATFORM'].downcase.to_sym
+        when :ios, :android
+          native_app_screen_objects
+        when :web
+          web_page_objects
+        end
+      end
+    end
+
+    def native_app_screen_objects
+        {
+          login_screen:            LoginScreen,
+          registration_screen:     RegistrationScreen,
+          search_results_screen:   SearchResultsScreen,
+          products_grid_screen:    ProductsCollectionScreen,
+          product_detail_screen:   ProductDetailScreen,
+          shopping_basket_screen:  ShoppingBasketScreen,
+          payment_method_screen:   PaymentMethodScreen,
+          confirm_purchase_screen: PurchaseConfirmationScreen,
+          my_account_screen:       MyAccountScreen,
+          my_order_history_screen: MyOrderHistoryScreen
+        }
+    end
+
+    def web_page_objects
+        {
+          login_screen:            LoginPage,
+          registration_screen:     RegistrationPage,
+          search_results_screen:   SearchResultsPage,
+          products_grid_screen:    ProductsCollectionPage,
+          product_detail_screen:   ProductDetailPage,
+          shopping_basket_screen:  ShoppingBasketPage,
+          payment_method_screen:   PaymentMethodPage,
+          confirm_purchase_screen: PurchaseConfirmationPage,
+          my_account_screen:       MyAccountPage,
+          my_order_history_screen: MyOrderHistoryPage
+        }
+    end
+
+    World(WorldPages)
 
 
 ### Leveraging the PageManager in your Cucumber tests
@@ -782,914 +801,449 @@ executed:
 Many Cucumber based automated tests suites include scenarios that verify that web pages are correctly loaded, displayed, or can be
 navigated to by clicking associated links. One such Cucumber navigation scenario is displayed below:
 
-    Scenario Outline:  Verify Home page navigation links
-      Given I am on the Home page
-      When I click the <page> navigation link
-      Then I expect the <page> page to be correctly displayed
-    
+    Scenario Outline:  Verify screen navigation features
+      Given I am on the Products screen
+      When I tap the <screen_name> navigation menu item
+      Then I expect the <screen_name> screen to be correctly displayed
+
       Examples:
-        |page                    |
-        |Registration            |
-        |My Account              |
-        |Terms & Conditions      |
-        |Privacy Policy          |
-        |FAQs                    |
-        |Contact Us              |
-
-In the above example, the step definitions associated with the 3 steps might be implemented using a page_dispatcher method using a
-`case` statement to parse the `page` parameter as in the example below:
-
-    Given(/^I am on the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
+        |screen_name      |
+        |Registration     |
+        |Shopping Basket  |
+        |My Account       |
+        |My Order History |
+
+In the above example, the step definitions associated with the 3 steps can be implemented using the `PageManager.find_page` method
+to match the specified `screen_name` argument with the corresponding `ScreenObject` as shown below:
+
+    include TestCentricity
+
+    When(/^I (?:load|am on) the (.*) (?:page|screen)$/) do |screen_name|
+      # find and load the specified target page/screen
+      target_page = PageManager.find_page(screen_name)
       target_page.load_page
     end
     
-    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
-      target_page = page_dispatcher(link_name)
+    
+    When(/^I (?:click|tap) the ([^\"]*) navigation menu item$/) do |screen_name|
+      # find and navigate to the specified target page/screen
+      target_page = PageManager.find_page(screen_name)
       target_page.navigate_to
     end
     
-    Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
-      target_page = page_dispatcher(page_name)
+    
+    Then(/^I expect the (.*) (?:page|screen) to be correctly displayed$/) do |screen_name|
+      # find and verify that the specified target page/screen is loaded
+      target_page = PageManager.find_page(screen_name)
       target_page.verify_page_exists
+      # verify that target page/screen is correctly displayed
       target_page.verify_page_ui
     end
-    
-    # this method takes a page name as a parameter and returns an instance of the associated Page Object
-    def page_dispatcher(page_name)
-      case page_name
-      when 'Registration'
-        page = registration_page
-      when 'My Account'
-        page = my_account_page
-      when 'Terms & Conditions'
-        page = terms_conditions_page
-      when 'Privacy Policy'
-        page = privacy_policy_page
-      when 'Contact Us'
-        page = contact_us_page
-      when 'FAQs'
-        page = faqs_page
-      end
-      raise "No page object defined for page named '#{page_name}'" unless page
-      page
-    end
 
 
-While this approach may be effective for small web applications with only a few pages (and hence few **Page Objects**), it quickly becomes
-cumbersome to manage if your web application has dozens of **Page Objects** that need to be managed.
 
-The **PageManager** class provides a `find_page` method that replaces the cumbersome and difficult to maintain `case` statement used in the
-above example. The **PageManager** `current_page` method allows you to set or get an instance of the currently active Page Object.
+## Connecting to a Mobile Simulator or Device
 
-To use these **PageManager** methods, include the step definitions and code below in a `page_steps.rb` or `generic_steps.rb` file in the
-`features/step_definitions` folder:
+The `AppiumConnect.initialize_appium` method configures the appropriate Appium capabilities required to establish a connection
+with a locally or cloud hosted target iOS or Android simulator or real device.
 
-    include TestCentricity
-    
-    Given(/^I am on the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.load_page if target_page
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
-    end
-    
-    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
-      target_page = page_dispatcher(link_name)
-      target_page.navigate_to if target_page
-    end
-    
-    Then(/^I expect to see the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.verify_page_exists if target_page
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
-    end
-    
-    Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.verify_page_exists
-      target_page.verify_page_ui
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
+
+### Starting and stopping Appium Server
+
+The Appium server must be running prior to invoking Cucumber to run your features/scenarios on locally hosted mobile simulators
+or physical device. To programmatically control the starting and stopping of Appium server with the execution of your automated
+tests, place the code shown below into your `hooks.rb` file.
+
+    BeforeAll do
+      # start Appium Server if command line option was specified and target browser is mobile simulator or device
+      if ENV['APPIUM_SERVER'] == 'run' && Environ.driver == :appium
+       end
     end
     
-    # this method takes a page name as a parameter and returns an instance of the associated Page Object
-    def page_dispatcher(page_name)
-      page = PageManager.find_page(page_name)
-      raise "No page object defined for page named '#{page_name}'" unless page
-      page
+    AfterAll do
+      # terminate Appium Server if command line option was specified and target browser is mobile simulator or device
+      if ENV['APPIUM_SERVER'] == 'run' && Environ.driver == :appium && $server.running?
+        $server.stop
+      end
     end
 
 
+The `APPIUM_SERVER` environment variable must be set to `run` in order to programmatically start and stop Appium server. This can be
+set by adding the following to your `cucumber.yml` file and including `-p run_appium` in your command line when starting your Cucumber
+test suite(s):
+
+    run_appium: APPIUM_SERVER=run
+
 
-## Connecting to a Web Browser
-
-The `TestCentricity::WebDriverConnect.initialize_web_driver` method configures the appropriate selenium-webdriver capabilities required to establish a
-connection with a target web browser, and sets the base host URL of the web site you are running your tests against.
-
-The `TestCentricity::WebDriverConnect.initialize_web_driver` method accepts a single optional parameter - the base host URL. Cucumber **Environment
-Variables** are used to specify the target local or remote web browser, and the various webdriver capability parameters required to configure
-the connection.
-
-
-### Locally hosted desktop web browser
-
-For locally hosted desktop web browsers running on macOS (OS X) or Windows platforms, the `WEB_BROWSER` Environment Variable must be set to one of the
-values from the table below: 
-
-`WEB_BROWSER` | **Desktop Platform**
---------------|----------------
-`firefox`     | macOS (OS X) or Windows
-`chrome`      | macOS (OS X) or Windows
-`safari`      | macOS (OS X) only
-`ie`          | Windows only
-`poltergeist` | macOS (OS X) or Windows
-
-To set the size of a desktop browser window, you set the `BROWSER_SIZE` Environment Variable to the desired width and height in pixels as shown below:
-                                                                                                                               
-    BROWSER_SIZE=1600,1000
-
-To maximize a desktop browser window, you set the `BROWSER_SIZE` Environment Variable to 'max' as shown below:
-                                                                                                                               
-    BROWSER_SIZE=max
-
-
-### Locally hosted emulated mobile web browser
-
-You can run your tests against mobile device browsers that are emulated within a locally hosted instance of a Chrome desktop browser on OS X or
-Windows. The specified mobile browser's user agent, CSS screen dimensions, and default screen orientation will be automatically set within the
-local Chrome browser instance. You may even specify the emulated device's screen orientation. For locally hosted emulated mobile web browsers,
-the `WEB_BROWSER` Environment Variable must be set to one of the values from the table below: 
-
-`WEB_BROWSER`         | `HOST_BROWSER` | **CSS Screen Dimensions** | **Default Orientation**  | **OS Version**
-----------------------|----------------------|-----------|----------|---------
-`ipad`                |`chrome`        |1024 x 768 |landscape |iOS 10
-`ipad_pro`            |`chrome`        |1366 x 1024|landscape |iOS 11
-`ipad_pro_10_5`       |`chrome`        |1112 x 834 |landscape |iOS 11
-`ipad_chrome`         |`chrome`        |1024 x 768 |landscape |iOS 10 - Mobile Chrome browser for iOS
-`ipad_firefox`        |`chrome`        |1024 x 768 |landscape |iOS 10 - Mobile Firefox browser for iOS
-`ipad_edge`           |`chrome`        |1024 x 768 |landscape |iOS 10 - Mobile Edge browser for iOS
-`android_tablet`      |`chrome`        |1024 x 768 |landscape |Android 3.0
-`kindle_fire`         |`chrome`        |1024 x 600 |landscape |
-`kindle_firehd7`      |`chrome`        |800 x 480  |landscape |Fire OS 3
-`kindle_firehd8`      |`chrome`        |1280 x 800 |landscape |Fire OS 5
-`kindle_firehd10`     |`chrome`        |1920 x 1200 |landscape |Fire OS 5
-`surface`             |`chrome`        |1366 x 768 |landscape |
-`blackberry_playbook` |`chrome`        |1024 x 600 |landscape |BlackBerry Tablet OS
-`samsung_galaxy_tab`  |`chrome`        |1280 x 800 |landscape |Android 4.0.4
-`google_nexus7`       |`chrome`        |960 x 600  |landscape |Android 4.4.4
-`google_nexus9`       |`chrome`        |1024 x 768 |landscape |Android 5.1
-`google_nexus10`      |`chrome`        |1280 x 800 |landscape |Android 5.1
-`iphone`              |`chrome`        |320 x 480  |portrait  |iOS 9.1
-`iphone4`             |`chrome`        |320 x 480  |portrait  |iOS 9.1
-`iphone5`             |`chrome`        |320 x 568  |portrait  |iOS 9.1
-`iphone6`             |`chrome`        |375 x 667  |portrait  |iOS 9.1
-`iphone6_plus`        |`chrome`        |414 x 736  |portrait  |iOS 9.1
-`iphone7`             |`chrome`        |375 x 667  |portrait  |iOS 10
-`iphone7_plus`        |`chrome`        |414 x 736  |portrait  |iOS 10
-`iphone7_chrome`      |`chrome`        |375 x 667  |portrait  |iOS 11 - Mobile Chrome browser for iOS
-`iphone7_firefox`     |`chrome`        |375 x 667  |portrait  |iOS 11 - Mobile Firefox browser for iOS
-`iphone7_edge`        |`chrome`        |375 x 667  |portrait  |iOS 11 - Microsoft Edge browser for iOS
-`iphone8`             |`chrome`        |375 x 667  |portrait  |iOS 11
-`iphone8_plus`        |`chrome`        |414 x 736  |portrait  |iOS 11
-`iphonex`             |`chrome`        |375 x 812  |portrait  |iOS 11
-`android_phone`       |`chrome`        |360 x 640  |portrait  |Android 4.2.1
-`nexus6`              |`chrome`        |411 x 731  |portrait  |Android 6
-`pixel`               |`chrome`        |411 x 731  |portrait  |Android 8
-`pixel_xl`            |`chrome`        |411 x 731  |portrait  |Android 8
-`samsung_galaxy_s4`   |`chrome`        |360 x 640  |portrait  |Android 5.0.1
-`samsung_galaxy_s5`   |`chrome`        |360 x 640  |portrait  |Android 6.0.1
-`samsung_galaxy_s6`   |`chrome`        |360 x 640  |portrait  |Android 6.0.1
-`windows_phone7`      |`chrome`        |320 x 480  |portrait  |Windows Phone OS 7.5
-`windows_phone8`      |`chrome`        |320 x 480  |portrait  |Windows Phone OS 8.0
-`lumia_950_xl`        |`chrome`        |360 x 640  |portrait  |Windows Phone OS 10
-`blackberry_z10`      |`chrome`        |384 x 640  |portrait  |BlackBerry 10 OS
-`blackberry_z30`      |`chrome`        |360 x 640  |portrait  |BlackBerry 10 OS
-`blackberry_leap`     |`chrome`        |360 x 640  |portrait  |BlackBerry 10 OS
-`blackberry_passport` |`chrome`        |504 x 504  |square    |BlackBerry 10 OS
-
-To change the emulated device's screen orientation from the default setting, set the `ORIENTATION` Environment Variable to either `portrait` or `landscape`.
-
-To use a local instance of the Chrome desktop browser to host the emulated mobile web browser, you must set the `HOST_BROWSER` Environment Variable
-to `chrome`.
-
-
-### Mobile Safari browser on iOS Simulators or iOS Physical Devices
-
-You can run your mobile web tests against the mobile Safari browser on simulated iOS devices or physically connected iOS devices using Appium and XCode on
-OS X. You must install Appium, XCode, and the iOS version-specific device simulators for XCode. You must also ensure that the `appium_capybara` gem is
-installed and required as described in **section 2.4 (Setup - Using Appium)** above.
-
-Information about Appium setup and configuration requirements for testing on physically connected iOS devices can be found on [this page](https://github.com/appium/appium/blob/master/docs/en/drivers/ios-xcuitest-real-devices.md).
+### Connecting to Locally Hosted iOS Simulators or Physical Devices
+
+You can run your automated tests on locally hosted iOS simulators or physically connected devices using Appium and XCode on macOS. You
+must install Appium, XCode, and the iOS version-specific device simulators for XCode. Information about Appium setup and configuration
+requirements for testing on physically connected iOS devices can be found on [this page](https://github.com/appium/appium/blob/master/docs/en/drivers/ios-xcuitest-real-devices.md).
 The Appium server must be running prior to invoking Cucumber to run your features/scenarios.
 
 Once your test environment is properly configured, the following **Environment Variables** must be set as described in the table below.
 
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`       | Must be set to `appium`
-`APP_PLATFORM_NAME` | Must be set to `iOS`
-`APP_BROWSER`       | Must be set to `Safari`
-`APP_VERSION`       | Must be set to `11.2`, `10.3`, `9.3`, or which ever iOS version you wish to run within the XCode Simulator
-`APP_DEVICE`        | Set to iOS device name supported by the iOS Simulator (`iPhone 6s Plus`, `iPad Pro (10.5-inch)`, `iPad Air 2`, etc.) or name of physically connected iOS device
-`DEVICE_TYPE`       | Must be set to `phone` or `tablet`
-`APP_UDID`          | UDID of physically connected iOS device (not used for simulators)
-`TEAM_ID`           | unique 10-character Apple developer team identifier string (not used for simulators)
-`TEAM_NAME`         | String representing a signing certificate (not used for simulators)
-`APP_ALLOW_POPUPS`  | [Optional] Allow javascript to open new windows in Safari. Set to `true` or `false`
-`APP_IGNORE_FRAUD_WARNING` | [Optional] Prevent Safari from showing a fraudulent website warning. Set to `true` or `false`
-`APP_NO_RESET`      | [Optional] Don't reset app state after each test. Set to `true` or `false`
-`APP_FULL_RESET`    | [Optional] Perform a complete reset. Set to `true` or `false`
-`APP_INITIAL_URL`   | [Optional] Initial URL, default is a local welcome page.  e.g.  `http://www.apple.com`
-`WDA_LOCAL_PORT`    | [Optional] Used to forward traffic from Mac host to real iOS devices over USB. Default value is same as port number used by WDA on device.
-`LOCALE`            | [Optional] Locale to set for the simulator.  e.g.  `fr_CA`
-`LANGUAGE`          | [Optional] Language to set for the simulator.  e.g.  `fr`
-`ORIENTATION`       | [Optional] Set to `portrait` or `landscape` (only for iOS simulators)
-`NEW_COMMAND_TIMEOUT` | [Optional] Time (in Seconds) that Appium will wait for a new command from the client
-
-
-### Mobile Chrome or Android browsers on Android Studio Virtual Device emulators
-
-You can run your mobile web tests against the mobile Chrome or Android browser on emulated Android devices using Appium and Android Studio on OS X. You
-must install Android Studio, the desired Android version-specific virtual device emulators, and Appium. Refer to [this page](https://github.com/appium/ruby_console/blob/master/osx.md)
-for information on configuring Appium to work with the Android SDK. You must also ensure that the `appium_capybara` gem is installed and required as
-described in **section 2.4 (Setup - Using Appium)** above.
-
-The Appium server must be running prior to invoking Cucumber to run your features/scenarios. Refer to [this page](https://appium.io/docs/en/writing-running-appium/web/chromedriver/index.html)
-for information on configuring Appium to use the correct version of Chromedriver required to work with the web browser supported by each Android OS version.
+| **Environment Variable**   | **Description**                                                                                                                                                       |
+|----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `WEB_BROWSER`              | Must be set to `appium`                                                                                                                                               |
+| `APP_PLATFORM_NAME`        | Must be set to `iOS`                                                                                                                                                  |
+| `AUTOMATION_ENGINE`        | Must be set to `XCUITest`                                                                                                                                             |
+| `APP_VERSION`              | Must be set to `15.4`, `14.5`, or which ever iOS version you wish to run within the XCode Simulator                                                                   |
+| `APP_DEVICE`               | Set to iOS device name supported by the iOS Simulator (`iPhone 13 Pro Max`, `iPad Pro (12.9-inch) (5th generation)`, etc.) or name of physically connected iOS device |
+| `DEVICE_TYPE`              | Must be set to `phone` or `tablet`                                                                                                                                    |
+| `APP_UDID`                 | UDID of physically connected iOS device (not used for simulators)                                                                                                     |
+| `TEAM_ID`                  | unique 10-character Apple developer team identifier string (not used for simulators)                                                                                  |
+| `TEAM_NAME`                | String representing a signing certificate (not used for simulators)                                                                                                   |
+| `APP_NO_RESET`             | [Optional] Don't reset app state after each test. Set to `true` or `false`                                                                                            |
+| `APP_FULL_RESET`           | [Optional] Perform a complete reset. Set to `true` or `false`                                                                                                         |
+| `WDA_LOCAL_PORT`           | [Optional] Used to forward traffic from Mac host to real iOS devices over USB. Default value is same as port number used by WDA on device.                            |
+| `LOCALE`                   | [Optional] Locale to set for the simulator.  e.g.  `fr_CA`                                                                                                            |
+| `LANGUAGE`                 | [Optional] Language to set for the simulator.  e.g.  `fr`                                                                                                             |
+| `ORIENTATION`              | [Optional] Set to `portrait` or `landscape` (only for iOS simulators)                                                                                                 |
+| `NEW_COMMAND_TIMEOUT`      | [Optional] Time (in Seconds) that Appium will wait for a new command from the client                                                                                  |
 
-Once your test environment is properly configured, the following **Environment Variables** must be set as described in the table below.
 
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`       | Must be set to `appium`
-`APP_PLATFORM_NAME` | Must be set to `Android`
-`APP_BROWSER`       | Must be set to `Chrome` or `Browser`
-`APP_VERSION`       | Must be set to `8.0`, `7.0`, or which ever Android OS version you wish to run with the Android Virtual Device
-`APP_DEVICE`        | Set to Android Virtual Device ID (`Pixel_2_XL_API_26`, `Nexus_6_API_23`, etc.) found in Advanced Settings of AVD Configuration
-`DEVICE_TYPE`       | Must be set to `phone` or `tablet`
-`ORIENTATION`       | [Optional] Set to `portrait` or `landscape`
-`APP_INITIAL_URL`   | [Optional] Initial URL, default is a local welcome page.  e.g.  `http://www.apple.com`
-`APP_NO_RESET`      | [Optional] Don't reset app state after each test. Set to `true` or `false`
-`APP_FULL_RESET`    | [Optional] Perform a complete reset. Set to `true` or `false`
-`LOCALE`            | [Optional] Locale to set for the simulator.  e.g.  `fr_CA`
-`LANGUAGE`          | [Optional] Language to set for the simulator.  e.g.  `fr`
-`NEW_COMMAND_TIMEOUT` | [Optional] Time (in Seconds) that Appium will wait for a new command from the client
-`CHROMEDRIVER_EXECUTABLE` | [Optional] Absolute local path to webdriver executable
+Refer to **section 9.5 (Using Configuration Specific Profiles in cucumber.yml)** below.
 
 
-### Remotely hosted desktop and mobile web browsers
+### Connecting to Locally Hosted Android Simulators or Physical Devices
 
-You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, CrossBrowserTesting,
-Sauce Labs, or TestingBot services. If your tests are running against a web site hosted on your local computer (`localhost`), or on a
-staging server inside your LAN, you must set the `TUNNELING` Environment Variable to `true`.
+You can run your automated tests on emulated Android devices using Appium and Android Studio on macOS. You must install Android
+Studio, the desired Android version-specific virtual device emulators, and Appium. Refer to [this page](http://appium.io/docs/en/drivers/android-uiautomator2/index.html)
+for information on configuring Appium to work with the Android SDK. The Appium server must be running prior to invoking Cucumber
+to run your features/scenarios.
 
+Once your test environment is properly configured, the following **Environment Variables** must be set as described in the table below.
 
-#### Remote desktop browsers on the BrowserStack service
+| **Environment Variable**  | **Description**                                                                                                                |
+|---------------------------|--------------------------------------------------------------------------------------------------------------------------------|
+| `WEB_BROWSER`             | Must be set to `appium`                                                                                                        |
+| `APP_PLATFORM_NAME`       | Must be set to `Android`                                                                                                       |
+| `AUTOMATION_ENGINE`       | Must be set to `UiAutomator2`                                                                                                  |
+| `APP_VERSION`             | Must be set to `12.0`, or which ever Android OS version you wish to run with the Android Virtual Device                        |
+| `APP_DEVICE`              | Set to Android Virtual Device ID (`Pixel_2_XL_API_26`, `Nexus_6_API_23`, etc.) found in Advanced Settings of AVD Configuration |
+| `DEVICE_TYPE`             | Must be set to `phone` or `tablet`                                                                                             |
+| `APP_UDID`                | UDID of physically connected Android device (not used for simulators)                                                          |
+| `ORIENTATION`             | [Optional] Set to `portrait` or `landscape`                                                                                    |
+| `APP_NO_RESET`            | [Optional] Don't reset app state after each test. Set to `true` or `false`                                                     |
+| `APP_FULL_RESET`          | [Optional] Perform a complete reset. Set to `true` or `false`                                                                  |
+| `LOCALE`                  | [Optional] Locale to set for the simulator.  e.g.  `fr_CA`                                                                     |
+| `LANGUAGE`                | [Optional] Language to set for the simulator.  e.g.  `fr`                                                                      |
+| `NEW_COMMAND_TIMEOUT`     | [Optional] Time (in Seconds) that Appium will wait for a new command from the client                                           |
 
-For remotely hosted desktop web browsers on the BrowserStack service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack)
-for information regarding the specific capabilities.
 
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`   | Must be set to `browserstack`
-`BS_USERNAME`   | Must be set to your BrowserStack account user name
-`BS_AUTHKEY`    | Must be set to your BrowserStack account access key
-`BS_OS`         | Must be set to `OS X` or `Windows`
-`BS_OS_VERSION` | Refer to `os_version` capability in chart
-`BS_BROWSER`    | Refer to `browser` capability in chart
-`BS_VERSION`    | [Optional] Refer to `browser_version` capability in chart. If not specified, latest stable version of browser will be used.
-`TUNNELING`     | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started.
-`RESOLUTION`    | [Optional] Refer to supported screen `resolution` capability in chart
-`BROWSER_SIZE`  | [Optional] Specify width, height of browser window
-`RECORD_VIDEO`  | [Optional] Enable screen video recording during test execution (`true` or `false`)
-`TIME_ZONE`     | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
-
-If the BrowserStack Local instance is running (`TUNNELING` Environment Variable is `true`), call the`TestCentricity::WebDriverConnect.close_tunnel` method
-upon completion of your test suite to stop the Local instance. Place the code shown below in your `env.rb` file.
-
-    # Code to stop BrowserStack Local instance after end of test (if tunneling is enabled)
-    at_exit do
-      TestCentricity::WebDriverConnect.close_tunnel if Environ.tunneling
-    end
+Refer to **section 9.5 (Using Configuration Specific Profiles in cucumber.yml)** below.
+
+
+###  Connecting to Remote Cloud Hosted iOS and Android Simulators or Physical Devices
 
+You can run your automated tests against remote cloud hosted iOS and Android simulators and real devices using the BrowserStack,
+SauceLabs, or TestingBot services. Refer to **section 9.5 (Using Configuration Specific Profiles in cucumber.yml)** below.
 
-#### Remote mobile browsers on the BrowserStack service
 
-For remotely hosted mobile web browsers on the BrowserStack service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack)
+#### Remote iOS and Android Physical Devices on the BrowserStack service
+
+For remotely hosted iOS and Android simulators and real devices on the BrowserStack service, the following **Environment Variables**
+must be set as described in the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/app-automate/capabilities?tag=w3c)
 for information regarding the specific capabilities.
 
-**Environment Variable** | **Description**
----------------  | ----------------
-`WEB_BROWSER`    | Must be set to `browserstack`
-`BS_USERNAME`    | Must be set to your BrowserStack account user name
-`BS_AUTHKEY`     | Must be set to your BrowserStack account access key
-`BS_OS`          | Must be set to `ios` or `android`
-`BS_BROWSER`     | Must be set to `iPhone`, `iPad`, or `android`
-`BS_PLATFORM`    | Must be set to `MAC` (for iOS) or `ANDROID`
-`BS_DEVICE`      | Refer to `device` capability in chart
-`BS_REAL_MOBILE` | Set to `true` if running against a real device
-`DEVICE_TYPE`    | Must be set to `phone` or `tablet`
-`TUNNELING`      | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started.
-`ORIENTATION`    | [Optional] Set to `portrait` or `landscape`
-`RECORD_VIDEO`   | [Optional] Enable screen video recording during test execution (`true` or `false`)
-`TIME_ZONE`      | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
-
-
-
-#### Remote desktop browsers on the CrossBrowserTesting service
-
-For remotely hosted desktop web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
-the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
-information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`  | Must be set to `crossbrowser`
-`CB_USERNAME`  | Must be set to your CrossBrowserTesting account user name or email address
-`CB_AUTHKEY`   | Must be set to your CrossBrowserTesting account access key
-`CB_OS`        | Refer to `os_api_name` capability in the sample script of the Wizard
-`CB_BROWSER`   | Refer to `browser_api_name` capability in the sample script of the Wizard
-`RESOLUTION`   | [Optional] Refer to supported `screen_resolution` capability in the sample script of the Wizard
-`BROWSER_SIZE` | [Optional] Specify width, height of browser window
-`RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
-
-
-#### Remote mobile browsers on the CrossBrowserTesting service
-
-For remotely hosted mobile web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
-the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
-information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`  | Must be set to `crossbrowser`
-`CB_USERNAME`  | Must be set to your CrossBrowserTesting account user name or email address
-`CB_AUTHKEY`   | Must be set to your CrossBrowserTesting account access key
-`CB_PLATFORM`  | Refer to `os_api_name` capability in the sample script of the Wizard
-`CB_BROWSER`   | Refer to `browser_api_name` capability in the sample script of the Wizard
-`RESOLUTION`   | Refer to supported `screen_resolution` capability in the sample script of the Wizard
-`DEVICE_TYPE`  | Must be set to `phone` or `tablet`
-`RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
-
-
-
-#### Remote desktop browsers on the Sauce Labs service
-
-For remotely hosted desktop web browsers on the Sauce Labs service, the following **Environment Variables** must be set as described in
-the table below. Use the Selenium API on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/) to obtain
-information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`  | Must be set to `saucelabs`
-`SL_USERNAME`  | Must be set to your Sauce Labs account user name or email address
-`SL_AUTHKEY`   | Must be set to your Sauce Labs account access key
-`SL_OS`        | Refer to `platform` capability in the Copy Code section of the Platform Configurator page
-`SL_BROWSER`   | Must be set to `chrome`, `firefox`, `safari`, `internet explorer`, or `edge`
-`SL_VERSION`   | Refer to `version` capability in the Copy Code section of the Platform Configurator page
-`RESOLUTION`   | [Optional] Refer to supported `screenResolution` capability in the Copy Code section of the Platform Configurator page
-`BROWSER_SIZE `| [Optional] Specify width, height of browser window
-`RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
-
-
-#### Remote desktop browsers on the TestingBot service
-
-For remotely hosted desktop web browsers on the TestingBot service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information
-regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER` | Must be set to `testingbot`
-`TB_USERNAME` | Must be set to your TestingBot account user name
-`TB_AUTHKEY`  | Must be set to your TestingBot account access key
-`TB_OS`       | Refer to `platform` capability in chart
-`TB_BROWSER`  | Refer to `browserName` capability in chart
-`TB_VERSION`  | Refer to `version` capability in chart
-`TUNNELING`   | Must be `true` if you are testing against internal/local servers (`true` or `false`)
-`RESOLUTION`  | [Optional] Possible values: `800x600`, `1024x768`, `1280x960`, `1280x1024`, `1600x1200`, `1920x1200`, `2560x1440`
-`BROWSER_SIZE`| [Optional] Specify width, height of browser window
-
-
-#### Remote mobile browsers on the TestingBot service
-
-For remotely hosted mobile web browsers on the TestingBot service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information
-regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER` | Must be set to `testingbot`
-`TB_USERNAME` | Must be set to your TestingBot account user name
-`TB_AUTHKEY`  | Must be set to your TestingBot account access key
-`TB_OS`       | Must be set to `MAC` (for iOS) or `ANDROID`
-`TB_BROWSER`  | Must be set to `safari` (for iOS) or `browser` (for Android)
-`TB_VERSION`  | Refer to `version` capability in chart
-`TB_PLATFORM` | Must be set to `iOS` or `ANDROID`
-`TB_DEVICE`   | Refer to `deviceName` capability in chart
-`DEVICE_TYPE` | Must be set to `phone` or `tablet`
-`TUNNELING`   | Must be `true` if you are testing against internal/local servers (`true` or `false`)
-`ORIENTATION` | [Optional] Set to `portrait` or `landscape`
-
+| **Environment Variable** | **Description**                                                                                                                     |
+|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------|
+| `WEB_BROWSER`            | Must be set to `browserstack`                                                                                                       |
+| `BS_USERNAME`            | Must be set to your BrowserStack account user name                                                                                  |
+| `BS_AUTHKEY`             | Must be set to your BrowserStack account access key                                                                                 |
+| `BS_OS`                  | Must be set to `ios` or `android`                                                                                                   |
+| `BS_DEVICE`              | Refer to `deviceName` capability in chart                                                                                           |
+| `BS_OS_VERSION`          | Set to the OS version specified in the `platformVersion` capability in the chart                                                    |
+| `DEVICE_TYPE`            | Must be set to `phone` or `tablet`                                                                                                  |
+| `ORIENTATION`            | [Optional] Set to `portrait` or `landscape`                                                                                         |
+| `RECORD_VIDEO`           | [Optional] Enable screen video recording during test execution (`true` or `false`)                                                  |
+| `TIME_ZONE`              | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart                                           |
+| `IP_GEOLOCATION`         | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code. |
+| `SCREENSHOTS`            | [Optional] Generate screenshots for debugging (`true` or `false`)                                                                   |
+| `NETWORK_LOGS`           | [Optional] Capture network logs (`true` or `false`)                                                                                 |
+| `APPIUM_LOGS`            | [Optional] Generate Appium logs (`true` or `false`)                                                                                 |
+
+
+#### Remote iOS and Android Physical Devices and Simulators on the Sauce Labs service
+
+For remotely hosted iOS and Android simulators and real devices on the Sauce Labs service, the following **Environment Variables**
+must be set as described in the table below. Refer to the [Platform Configurator page](https://saucelabs.com/platform/platform-configurator)
+to obtain information regarding the specific capabilities.
+
+| **Environment Variable** | **Description**                                                                                                 |
+|--------------------------|-----------------------------------------------------------------------------------------------------------------|
+| `WEB_BROWSER`            | Must be set to `saucelabs`                                                                                      |
+| `SL_USERNAME`            | Must be set to your Sauce Labs account user name or email address                                               |
+| `SL_AUTHKEY`             | Must be set to your Sauce Labs account access key                                                               |
+| `DATA_CENTER`            | Must be set to your Sauce Labs account Data Center assignment (`us-west-1`, `eu-central-1`, `apac-southeast-1`) |
+| `SL_OS`                  | Must be set to `ios` or `android`                                                                               |
+| `SL_DEVICE`              | Refer to `deviceName` capability in chart                                                                       |
+| `SL_OS_VERSION`          | Refer to `platformVersion` capability in the Config Script section of the Platform Configurator page            |
+| `DEVICE_TYPE`            | Must be set to `phone` or `tablet`                                                                              |
+| `ORIENTATION`            | [Optional] Set to `portrait` or `landscape`                                                                     |
+| `RECORD_VIDEO`           | [Optional] Enable screen video recording during test execution (`true` or `false`)                              |
+| `SCREENSHOTS`            | [Optional] Generate screenshots for debugging (`true` or `false`)                                               |
+
+
+#### Remote iOS and Android Physical Devices and Simulators on the TestingBot service
+
+For remotely hosted iOS and Android simulators and real devices on the TestingBot service, the following **Environment Variables**
+must be set as described in the table below. Refer to the [TestingBot List of Devices page](https://testingbot.com/support/devices)
+for information regarding the specific capabilities.
 
-### Using Browser specific Profiles in cucumber.yml
+| **Environment Variable** | **Description**                                   |
+|--------------------------|---------------------------------------------------|
+| `WEB_BROWSER`            | Must be set to `testingbot`                       |
+| `TB_USERNAME`            | Must be set to your TestingBot account user name  |
+| `TB_AUTHKEY`             | Must be set to your TestingBot account access key |
+| `TB_OS`                  | Must be set to `ios` or `android`                 |
+| `TB_DEVICE`              | Refer to `deviceName` capability in chart         |
+| `TB_OS_VERSION`          | Refer to `version` capability in chart            |
+| `DEVICE_TYPE`            | Must be set to `phone` or `tablet`                |
+| `REAL_DEVICE`            | Must be set to `true` for real devices            |
 
-While you can set **Environment Variables** in the command line when invoking Cucumber, a preferred method of specifying and managing
-target web browsers is to create browser specific **Profiles** that set the appropriate **Environment Variables** for each target browser
-in your `cucumber.yml` file.
 
-Below is a list of Cucumber **Profiles** for supported locally and remotely hosted desktop and mobile web browsers (put these in in your
-`cucumber.yml` file). Before you can use the BrowserStack, CrossBrowserTesting, Sauce Labs, or TestingBot services, you will need to
-replace the *INSERT USER NAME HERE* and *INSERT PASSWORD HERE* placeholder text with your user account and authorization code for the cloud
-service(s) that you intend to connect with.
 
+### Using Configuration Specific Profiles in cucumber.yml
 
-    <% desktop          = "--tags ~@wip --tags ~@failing --tags @desktop --require features BROWSER_SIZE=1600,1000" %>
-    <% mobile           = "--tags ~@wip --tags ~@failing --tags @mobile  --require features" %>
-    
-    #==============
-    # profiles for locally hosted desktop web browsers
-    #==============
-    
-    firefox:            WEB_BROWSER=firefox     <%= desktop %>
-    safari:             WEB_BROWSER=safari      <%= desktop %>
-    chrome:             WEB_BROWSER=chrome      <%= desktop %>
-    ie:                 WEB_BROWSER=ie          <%= desktop %>
-    headless:           WEB_BROWSER=poltergeist <%= desktop %>
-    
-    #==============
-    # profiles for locally hosted mobile web browsers (emulated locally in Firefox browser)
-    # NOTE: to host emulated mobile browsers in Chrome set the HOST_BROWSER=chrome
-    #==============
-    
-    ipad:                WEB_BROWSER=ipad                HOST_BROWSER=chrome <%= mobile %>
-    ipad_pro:            WEB_BROWSER=ipad_pro            HOST_BROWSER=chrome <%= mobile %>
-    ipad_pro_10_5:       WEB_BROWSER=ipad_pro_10_5       HOST_BROWSER=chrome <%= mobile %>
-    ipad_chrome:         WEB_BROWSER=ipad_chrome         HOST_BROWSER=chrome <%= mobile %>
-    ipad_firefox:        WEB_BROWSER=ipad_firefox        HOST_BROWSER=chrome <%= mobile %>
-    ipad_edge:           WEB_BROWSER=ipad_edge           HOST_BROWSER=chrome <%= mobile %>
-    iphone:              WEB_BROWSER=iphone              HOST_BROWSER=chrome <%= mobile %>
-    iphone4:             WEB_BROWSER=iphone4             HOST_BROWSER=chrome <%= mobile %>
-    iphone5:             WEB_BROWSER=iphone5             HOST_BROWSER=chrome <%= mobile %>
-    iphone6:             WEB_BROWSER=iphone6             HOST_BROWSER=chrome <%= mobile %>
-    iphone6_plus:        WEB_BROWSER=iphone6_plus        HOST_BROWSER=chrome <%= mobile %>
-    iphone7:             WEB_BROWSER=iphone7             HOST_BROWSER=chrome <%= mobile %>
-    iphone7_plus:        WEB_BROWSER=iphone7_plus        HOST_BROWSER=chrome <%= mobile %>
-    iphone7_chrome:      WEB_BROWSER=iphone7_chrome      HOST_BROWSER=chrome <%= mobile %>
-    iphone7_firefox:     WEB_BROWSER=iphone7_firefox     HOST_BROWSER=chrome <%= mobile %>
-    iphone7_edge:        WEB_BROWSER=iphone7_edge        HOST_BROWSER=chrome <%= mobile %>
-    iphone8:             WEB_BROWSER=iphone8             HOST_BROWSER=chrome <%= mobile %>
-    iphone8_plus:        WEB_BROWSER=iphone8_plus        HOST_BROWSER=chrome <%= mobile %>
-    iphoneX:             WEB_BROWSER=iphonex             HOST_BROWSER=chrome <%= mobile %>
-    android_phone:       WEB_BROWSER=android_phone       HOST_BROWSER=chrome <%= mobile %>
-    nexus6:              WEB_BROWSER=nexus6              HOST_BROWSER=chrome <%= mobile %>
-    android_tablet:      WEB_BROWSER=android_tablet      HOST_BROWSER=chrome <%= mobile %>
-    kindle_fire:         WEB_BROWSER=kindle_fire         HOST_BROWSER=chrome <%= mobile %>
-    kindle_firehd7:      WEB_BROWSER=kindle_firehd7      HOST_BROWSER=chrome <%= mobile %>
-    kindle_firehd8:      WEB_BROWSER=kindle_firehd8      HOST_BROWSER=chrome <%= mobile %>
-    kindle_firehd10:     WEB_BROWSER=kindle_firehd10     HOST_BROWSER=chrome <%= tablet %>
-    surface:             WEB_BROWSER=surface             HOST_BROWSER=chrome <%= mobile %>
-    blackberry_playbook: WEB_BROWSER=blackberry_playbook HOST_BROWSER=chrome <%= mobile %>
-    samsung_galaxy_tab:  WEB_BROWSER=samsung_galaxy_tab  HOST_BROWSER=chrome <%= mobile %>
-    google_nexus7:       WEB_BROWSER=google_nexus7       HOST_BROWSER=chrome <%= mobile %>
-    google_nexus9:       WEB_BROWSER=google_nexus9       HOST_BROWSER=chrome <%= mobile %>
-    google_nexus10:      WEB_BROWSER=google_nexus10      HOST_BROWSER=chrome <%= mobile %>
-    samsung_galaxy_s4:   WEB_BROWSER=samsung_galaxy_s4   HOST_BROWSER=chrome <%= mobile %>
-    samsung_galaxy_s5:   WEB_BROWSER=samsung_galaxy_s5   HOST_BROWSER=chrome <%= mobile %>
-    samsung_galaxy_s6:   WEB_BROWSER=samsung_galaxy_s6   HOST_BROWSER=chrome <%= mobile %>
-    pixel:               WEB_BROWSER=pixel               HOST_BROWSER=chrome <%= mobile %>
-    pixel_xl:            WEB_BROWSER=pixel_xl            HOST_BROWSER=chrome <%= mobile %>
-    windows_phone7:      WEB_BROWSER=windows_phone7      HOST_BROWSER=chrome <%= mobile %>
-    windows_phone8:      WEB_BROWSER=windows_phone8      HOST_BROWSER=chrome <%= mobile %>
-    lumia_950_xl:        WEB_BROWSER=lumia_950_xl        HOST_BROWSER=chrome <%= mobile %>
-    blackberry_z10:      WEB_BROWSER=blackberry_z10      HOST_BROWSER=chrome <%= mobile %>
-    blackberry_z30:      WEB_BROWSER=blackberry_z30      HOST_BROWSER=chrome <%= mobile %>
-    blackberry_leap:     WEB_BROWSER=blackberry_leap     HOST_BROWSER=chrome <%= mobile %>
-    blackberry_passport: WEB_BROWSER=blackberry_passport HOST_BROWSER=chrome <%= mobile %>
+While you can set **Environment Variables** in the command line when invoking Cucumber, a preferred method of specifying and managing
+target platforms is to create platform specific **Profiles** that set the appropriate **Environment Variables** for each target
+platform in your `cucumber.yml` file.
+
+Below is a list of Cucumber **Profiles** for supported locally and remotely hosted iOS and Android simulators and real devices (put
+these in in your `cucumber.yml` file). Before you can use the BrowserStack, SauceLabs, TestingBot or LambdaTest services, you will
+need to replace the *INSERT USER NAME HERE* and *INSERT PASSWORD HERE* placeholder text with your user account and authorization
+code for the cloud service(s) that you intend to connect with.
 
-    
     #==============
-    # profiles for mobile device screen orientation
+    # conditionally load Page and Screen Object implementations based on which target platform we're running on
     #==============
     
-    portrait:           ORIENTATION=portrait
-    landscape:          ORIENTATION=landscape
+    ios:     PLATFORM=ios --tags @ios -r features/support/ios -e features/support/android
+    android: PLATFORM=android --tags @android -r features/support/android -e features/support/ios
+    web:     PLATFORM=web --tags @web -r features/support/web -e features/support/ios -e features/support/android
     
     
     #==============
-    # profiles for mobile Safari web browsers hosted within XCode iOS simulator
-    # NOTE: Requires installation of XCode, iOS version specific target simulators, Appium, and the appium_capybara gem
+    # profiles for mobile device screen orientation
     #==============
     
-    appium_ios:            WEB_BROWSER=appium APP_PLATFORM_NAME="iOS" APP_BROWSER="Safari" <%= mobile %>
-    app_ios_10:            --profile appium_ios APP_VERSION="10.3"
-    app_ios_11:            --profile appium_ios APP_VERSION="11.2"
+    landscape: ORIENTATION=landscape
+    portrait:  ORIENTATION=portrait
     
-    iphone_7_plus_10_sim:  --profile app_ios_10 DEVICE_TYPE=phone APP_DEVICE="iPhone 7 Plus"
-    iphone_7_10_sim:       --profile app_ios_10 DEVICE_TYPE=phone APP_DEVICE="iPhone 7"
-    iphone_7se_10_sim:     --profile app_ios_10 DEVICE_TYPE=phone APP_DEVICE="iPhone SE"
-    iphone_6s_plus_10_sim: --profile app_ios_10 DEVICE_TYPE=phone APP_DEVICE="iPhone 6s Plus"
-    iphone_6s_10_sim:      --profile app_ios_10 DEVICE_TYPE=phone APP_DEVICE="iPhone 6s"
-    iphone_SE_10_sim:      --profile app_ios_10 DEVICE_TYPE=phone APP_DEVICE="iPhone SE"
-    iphone_X_11_sim:       --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone X"
-    iphone_8_11_sim:       --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone 8"
-    iphone_8_plus_11_sim:  --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone 8 Plus"
-    iphone_7_plus_11_sim:  --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone 7 Plus"
-    iphone_7_11_sim:       --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone 7"
-    iphone_7se_11_sim:     --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone SE"
-    iphone_6s_plus_11_sim: --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone 6s Plus"
-    iphone_6s_11_sim:      --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone 6s"
-    iphone_SE_11_sim:      --profile app_ios_11 DEVICE_TYPE=phone APP_DEVICE="iPhone SE"
     
-    ipad_pro_12_9_11_sim:  --profile app_ios_11 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch)"
-    ipad_pro_12_9_10_sim:  --profile app_ios_10 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch)"
-    ipad_pro_10_5_11_sim:  --profile app_ios_11 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (10.5-inch)"
-    ipad_pro_10_5_10_sim:  --profile app_ios_10 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (10.5-inch)"
-    ipad_pro_9_7_11_sim:   --profile app_ios_11 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (9.7-inch)"
-    ipad_pro_9_7_10_sim:   --profile app_ios_10 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (9.7-inch)"
-    ipad_air_2_11_sim:     --profile app_ios_11 DEVICE_TYPE=tablet APP_DEVICE="iPad Air 2"
-    ipad_air_2_10_sim:     --profile app_ios_10 DEVICE_TYPE=tablet APP_DEVICE="iPad Air 2"
-
-
     #==============
-    # profiles for mobile Safari web browsers running on physically connected iOS devices
-    # NOTE: Requires installation of XCode, Appium, and the appium_capybara gem
-    #==============
-
-    my_ios_10_3_iphone:    --profile app_ios_10 DEVICE_TYPE=phone APP_DEVICE="My Test iPhone6" APP_UDID="INSERT YOUR DEVICE UDID"
-    my_ios_10_3_ipad:      --profile app_ios_10 DEVICE_TYPE=tablet APP_DEVICE="My Test iPad Pro" APP_UDID="INSERT YOUR DEVICE UDID"
-
-
-    #==============
-    # profiles for Android mobile web browsers hosted within Android Studio Android Virtual Device emulators
-    # NOTE: Requires installation of Android Studio, Android version specific virtual device simulators, Appium, and the appium_capybara gem
+    # profile to start Appium Server prior to running mobile browser tests on iOS or Android simulators or physical devices
     #==============
+    run_appium: APPIUM_SERVER=run
     
-    appium_android:        WEB_BROWSER=appium APP_PLATFORM_NAME="Android" <%= mobile %>
-    android_api_26:        --profile appium_android APP_BROWSER="Chrome" APP_VERSION="8.0"
-    android_api_23:        --profile appium_android APP_BROWSER="Browser" APP_VERSION="6.0"
-    pixel_xl_api26_sim:    --profile android_api_26 DEVICE_TYPE=phone APP_DEVICE="Pixel_XL_API_26"
-    pixel_2_xl_api26_sim:  --profile android_api_26 DEVICE_TYPE=phone APP_DEVICE="Pixel_2_XL_API_26"
-    nexus_6_api23_sim:     --profile android_api_23 DEVICE_TYPE=phone APP_DEVICE="Nexus_6_API_23"
     
     #==============
-    # profiles for remotely hosted web browsers on the BrowserStack service
+    # profiles for native iOS apps hosted within XCode iOS simulators
+    # NOTE: Requires installation of XCode, iOS version specific target simulators, and Appium
     #==============
     
-    browserstack:       WEB_BROWSER=browserstack BS_USERNAME=<INSERT USER NAME HERE> BS_AUTHKEY=<INSERT PASSWORD HERE>
-    bs_desktop:         --profile browserstack <%= desktop %> RESOLUTION="1920x1080"
-    bs_mobile:          --profile browserstack <%= mobile %>
-    
-    # BrowserStack OS X desktop browser profiles
-    bs_macos_high_sierra:  --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="High Sierra"
-    bs_ff_high_sierra:     --profile bs_macos_high_sierra BS_BROWSER="Firefox"
-    bs_chrome_high_sierra: --profile bs_macos_high_sierra BS_BROWSER="Chrome"
-    bs_safari_high_sierra: --profile bs_macos_high_sierra BS_BROWSER="Safari"
-    
-    bs_macos_sierra:    --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Sierra"
-    bs_ff_sierra:       --profile bs_macos_sierra BS_BROWSER="Firefox"
-    bs_chrome_sierra:   --profile bs_macos_sierra BS_BROWSER="Chrome"
-    bs_safari_sierra:   --profile bs_macos_sierra BS_BROWSER="Safari"
-    
-    bs_osx_el_capitan:  --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="El Capitan"
-    bs_ff_el_cap:       --profile bs_osx_el_capitan BS_BROWSER="Firefox"
-    bs_chrome_el_cap:   --profile bs_osx_el_capitan BS_BROWSER="Chrome"
-    bs_safari_el_cap:   --profile bs_osx_el_capitan BS_BROWSER="Safari"
-    
-    bs_osx_yosemite:    --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Yosemite"
-    bs_ff_yos:          --profile bs_osx_yosemite BS_BROWSER="Firefox"
-    bs_chrome_yos:      --profile bs_osx_yosemite BS_BROWSER="Chrome"
-    bs_safari_yos:      --profile bs_osx_yosemite BS_BROWSER="Safari"
+    appium_ios: WEB_BROWSER=appium --profile ios AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="iOS" NEW_COMMAND_TIMEOUT="30" <%= mobile %>
+    app_ios_14: --profile appium_ios APP_VERSION="14.5"
+    app_ios_15: --profile appium_ios APP_VERSION="15.4"
     
-    bs_osx_mavericks:   --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Mavericks"
-    bs_ff_mav:          --profile bs_osx_mavericks BS_BROWSER="Firefox"
-    bs_chrome_mav:      --profile bs_osx_mavericks BS_BROWSER="Chrome"
-    bs_safari_mav:      --profile bs_osx_mavericks BS_BROWSER="Safari"
+    iphone_12PM_14_sim: --profile app_ios_14 DEVICE_TYPE=phone APP_DEVICE="iPhone 12 Pro Max"
+    iphone_13PM_15_sim: --profile app_ios_15 DEVICE_TYPE=phone APP_DEVICE="iPhone 13 Pro Max"
+    iphone_11_14_sim:   --profile app_ios_14 DEVICE_TYPE=phone APP_DEVICE="iPhone 11"
+    ipad_pro_12_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch) (5th generation)"
     
-    # BrowserStack Windows desktop browser profiles
-    bs_win7:            --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="7"
-    bs_win8:            --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="8"
-    bs_win10:           --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="10"
-    bs_ff_win7:         --profile bs_win7 BS_BROWSER="Firefox"
-    bs_ff_win8:         --profile bs_win8 BS_BROWSER="Firefox"
-    bs_ff_win10:        --profile bs_win10 BS_BROWSER="Firefox"
-    bs_chrome_win7:     --profile bs_win7 BS_BROWSER="Chrome"
-    bs_chrome_win8:     --profile bs_win8 BS_BROWSER="Chrome"
-    bs_chrome_win10:    --profile bs_win10 BS_BROWSER="Chrome"
-    
-    bs_ie_win7:         --profile bs_win7 BS_BROWSER="IE"
-    bs_ie11_win7:       --profile bs_ie_win7 BS_VERSION="11.0"
-    bs_ie10_win7:       --profile bs_ie_win7 BS_VERSION="10.0"
-    bs_ie9_win7:        --profile bs_ie_win7 BS_VERSION="9.0"
-    bs_ie10_win8:       --profile bs_win8 BS_BROWSER="IE" BS_VERSION="10.0"
-    bs_ie11_win8:       --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="8.1" BS_BROWSER="IE" BS_VERSION="11.0"
-    bs_ie11_win10:      --profile bs_win10 BS_BROWSER="IE" BS_VERSION="11.0"
-    bs_edge_win10:      --profile bs_win10 BS_BROWSER="Edge" BS_VERSION="15.0"
-    
-    # BrowserStack iOS mobile browser profiles
-    bs_iphone:          --profile bs_mobile BS_PLATFORM=MAC BS_OS=ios BS_BROWSER=iPhone DEVICE_TYPE=phone
-    bs_iphone6s_plus:   --profile bs_iphone BS_DEVICE="iPhone 6S Plus"
-    bs_iphone6s:        --profile bs_iphone BS_DEVICE="iPhone 6S"
-    bs_iphone6_plus:    --profile bs_iphone BS_DEVICE="iPhone 6 Plus"
-    bs_iphone6:         --profile bs_iphone BS_DEVICE="iPhone 6"
-    bs_iphone5s:        --profile bs_iphone BS_DEVICE="iPhone 5S"
-    bs_iphone4s:        --profile bs_iphone BS_DEVICE="iPhone 4S (6.0)"
-    
-    bs_ipad:            --profile bs_mobile BS_PLATFORM=MAC BS_BROWSER=iPad DEVICE_TYPE=tablet
-    bs_ipad_pro:        --profile bs_ipad BS_DEVICE="iPad Pro"
-    bs_ipad_air2:       --profile bs_ipad BS_DEVICE="iPad Air 2"
-    bs_ipad_air:        --profile bs_ipad BS_DEVICE="iPad Air"
-    bs_ipad_mini:       --profile bs_ipad BS_DEVICE="iPad Mini 4"
-    
-    # BrowserStack iOS real device mobile browser profiles
-    bs_iphone_device:   --profile bs_iphone BS_REAL_MOBILE="true"
-    bs_iphoneX:         --profile bs_iphone_device BS_OS_VERSION="11.0" BS_DEVICE="iPhone X"
-    bs_iphone8_plus:    --profile bs_iphone_device BS_OS_VERSION="11.0" BS_DEVICE="iPhone 8 Plus"
-    bs_iphone8:         --profile bs_iphone_device BS_OS_VERSION="11.0" BS_DEVICE="iPhone 8"
-    bs_iphone7_plus:    --profile bs_iphone_device BS_OS_VERSION="10.3" BS_DEVICE="iPhone 7 Plus"
-    bs_iphone7:         --profile bs_iphone_device BS_OS_VERSION="10.3" BS_DEVICE="iPhone 7"
-    
-    bs_ipad_device:     --profile bs_ipad BS_REAL_MOBILE="true"
-    bs_ipad5:           --profile bs_ipad_device BS_OS_VERSION="11.0" BS_DEVICE="iPad 5th"
-    
-    # BrowserStack Android mobile browser profiles
-    bs_android:          --profile bs_mobile BS_PLATFORM=ANDROID BS_BROWSER=android BS_OS=android
-    bs_android_phone:    --profile bs_android DEVICE_TYPE=phone
-    bs_galaxy_s5:        --profile bs_android_phone BS_DEVICE="Samsung Galaxy S5"
-    bs_nexus5:           --profile bs_android_phone BS_DEVICE="Google Nexus 5"
-    bs_moto_razr:        --profile bs_android_phone BS_DEVICE="Motorola Razr"
-    bs_sony_xperia:      --profile bs_android_phone BS_DEVICE="Sony Xperia Tipo"
-    
-    bs_android_tablet:   --profile bs_android DEVICE_TYPE=tablet
-    bs_kindle_fire_hd89: --profile bs_android_tablet BS_DEVICE="Amazon Kindle Fire HD 8.9"
-    bs_kindle_fire_hdx7: --profile bs_android_tablet BS_DEVICE="Amazon Kindle Fire HDX 7"
-    bs_kindle_fire2:     --profile bs_android_tablet BS_DEVICE="Amazon Kindle Fire 2"
-    bs_nexus7:           --profile bs_android_tablet BS_DEVICE="Google Nexus 7"
-    
-    # BrowserStack Android real device mobile browser profiles
-    bs_android_device:   --profile bs_mobile BS_BROWSER=android BS_OS=android BS_REAL_MOBILE="true"
-    bs_google_pixel8:    --profile bs_android_device BS_DEVICE="Google Pixel" BS_OS_VERSION="8.0" DEVICE_TYPE=phone
-    bs_google_pixel71:   --profile bs_android_device BS_DEVICE="Google Pixel" BS_OS_VERSION="7.1" DEVICE_TYPE=phone
-    bs_nexus6:           --profile bs_android_device BS_DEVICE="Google Nexus 6" DEVICE_TYPE=phone
-    bs_galaxy_s8_plus:   --profile bs_android_device BS_DEVICE="Samsung Galaxy S8 Plus" DEVICE_TYPE=phone
-    bs_galaxy_s8:        --profile bs_android_device BS_DEVICE="Samsung Galaxy S8" DEVICE_TYPE=phone
-    bs_galaxy_s7:        --profile bs_android_device BS_DEVICE="Samsung Galaxy S7" DEVICE_TYPE=phone
-    bs_galaxy_s6:        --profile bs_android_device BS_DEVICE="Samsung Galaxy S6" DEVICE_TYPE=phone
-    bs_galaxy_note4:     --profile bs_android_device BS_DEVICE="Samsung Galaxy Note 4" DEVICE_TYPE=tablet
-    bs_nexus9:           --profile bs_android_device BS_DEVICE="Google Nexus 9" DEVICE_TYPE=tablet
-
     
     #==============
-    # profiles for remotely hosted web browsers on the CrossBrowserTesting service
+    # profiles for native Android apps hosted within Android Studio Android Virtual Device emulators
+    # NOTE: Requires installation of Android Studio, Android version specific virtual device simulators, and Appium
     #==============
     
-    crossbrowser:       WEB_BROWSER=crossbrowser CB_USERNAME=<INSERT USER NAME HERE> CB_AUTHKEY=<INSERT PASSWORD HERE>
-    cb_desktop:         --profile crossbrowser <%= desktop %>
-    cb_mobile:          --profile crossbrowser <%= mobile %>
-    
-    # CrossBrowserTesting OS X desktop browser profiles
-    cb_osx:             --profile cb_desktop RESOLUTION="1920x1200"
-    cb_macos_sierra:    --profile cb_osx CB_OS="Mac10.12"
-    cb_chrome_sierra:   --profile cb_macos_sierra CB_BROWSER="Chrome53x64"
-    cb_safari_sierra:   --profile cb_macos_sierra CB_BROWSER="Safari10"
-    
-    cb_osx_el_capitan:  --profile cb_osx CB_OS="Mac10.11"
-    cb_ff_el_cap:       --profile cb_osx_el_capitan CB_BROWSER="FF46"
-    cb_chrome_el_cap:   --profile cb_osx_el_capitan CB_BROWSER="Chrome48x64"
-    cb_safari_el_cap:   --profile cb_osx_el_capitan CB_BROWSER="Safari9"
-    
-    cb_osx_yosemite:    --profile cb_osx CB_OS="Mac10.10"
-    cb_ff_yos:          --profile cb_osx_yosemite CB_BROWSER="FF46"
-    cb_chrome_yos:      --profile cb_osx_yosemite CB_BROWSER="Chrome48x64"
-    cb_safari_yos:      --profile cb_osx_yosemite CB_BROWSER="Safari8"
-    
-    cb_osx_mavericks:   --profile cb_osx CB_OS="Mac10.9"
-    cb_ff_mav:          --profile cb_osx_mavericks CB_BROWSER="FF46"
-    cb_chrome_mav:      --profile cb_osx_mavericks CB_BROWSER="Chrome48x64"
-    cb_safari_mav:      --profile cb_osx_mavericks CB_BROWSER="Safari7"
-    
-    # CrossBrowserTesting Windows desktop browser profiles
-    cb_win:             --profile cb_desktop RESOLUTION="1920x1080"
-    cb_win7:            --profile cb_win CB_OS="Win7x64-C1"
-    cb_win8:            --profile cb_win CB_OS="Win8"
-    cb_win10:           --profile cb_win CB_OS="Win10"
-    cb_ff_win7:         --profile cb_win7 CB_BROWSER="FF46"
-    cb_ff_win8:         --profile cb_win8 CB_BROWSER="FF46"
-    cb_ff_win10:        --profile cb_win10 CB_BROWSER="FF46"
-    cb_chrome_win7:     --profile cb_win7 CB_BROWSER="Chrome48x64"
-    cb_chrome_win8:     --profile cb_win8 CB_BROWSER="Chrome48x64"
-    cb_chrome_win10:    --profile cb_win10 CB_BROWSER="Chrome48x64"
-    cb_edge_win10:      --profile cb_win10 CB_BROWSER="Edge20"
-    
-    cb_ie11_win7:       --profile cb_win7 CB_BROWSER="IE11"
-    cb_ie10_win7:       --profile cb_win7 CB_BROWSER="IE10"
-    cb_ie9_win7:        --profile cb_win7 CB_BROWSER="IE9"
-    cb_ie11_win8:       --profile cb_win8 CB_BROWSER="IE11"
-    cb_ie10_win8:       --profile cb_win8 CB_BROWSER="IE10"
-    cb_ie11_win10:      --profile cb_win10 CB_BROWSER="IE11"
-    
-    # CrossBrowserTesting iOS mobile browser profiles
-    cb_iphone6s_plus:   --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6sPlus-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="1242x2208"
-    cb_iphone6s:        --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6s-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="750x1334"
-    cb_iphone6_plus:    --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6Plus-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="1242x2208"
-    cb_iphone6:         --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="750x1334"
-    cb_iphone5s:        --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone5s-iOS7sim" CB_BROWSER="MblSafari7.0" RESOLUTION="640x1136"
-    cb_ipad_pro:        --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadPro-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2732x2048"
-    cb_ipad_air2:       --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadAir2-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2048x1536"
-    cb_ipad_air:        --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadAir-iOS8Sim" CB_BROWSER="MblSafari8.0" RESOLUTION="2048x1536"
-    cb_ipad_mini:       --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadMiniRetina-iOS7Sim" CB_BROWSER="MblSafari7.0" RESOLUTION="2048x1536"
-    
-    # CrossBrowserTesting Android mobile browser profiles
-    cb_nexus7:          --profile cb_mobile CB_PLATFORM="Nexus7-And42" CB_BROWSER="MblChrome37" RESOLUTION="800x1280"
-    cb_galaxy_tab2:     --profile cb_mobile CB_PLATFORM="GalaxyTab2-And41" CB_BROWSER="MblChrome38" RESOLUTION="1280x800"
-    cb_galaxy_s5:       --profile cb_mobile CB_PLATFORM="GalaxyS5-And44" CB_BROWSER="MblChrome35" RESOLUTION="1080x1920"
-    cb_galaxy_s4:       --profile cb_mobile CB_PLATFORM="GalaxyS4-And42" CB_BROWSER="MblChrome33" RESOLUTION="1080x1920"
+    appium_android:    WEB_BROWSER=appium --profile android AUTOMATION_ENGINE=UiAutomator2 APP_PLATFORM_NAME="Android" <%= mobile %>
+    app_android_12:    --profile appium_android APP_VERSION="12.0"
+    pixel_5_api31_sim: --profile app_android_12 DEVICE_TYPE=phone APP_DEVICE="Pixel_5_API_31"
     
     
     #==============
-    # profiles for remotely hosted web browsers on the SauceLabs service
+    # profiles for remotely hosted devices on the BrowserStack service
+    # WARNING: Credentials should not be stored as text in your cucumber.yml file where it can be exposed by anyone with access
+    #          to your version control system
     #==============
     
-    saucelabs:          WEB_BROWSER=saucelabs SL_USERNAME=<INSERT USER NAME HERE> SL_AUTHKEY=<INSERT PASSWORD HERE>
-    sl_desktop:         --profile saucelabs <%= desktop %>
-    
-    # SauceLabs OS X desktop browser profiles
-    sl_osx_sierra:      --profile sl_desktop SL_OS="macOS 10.12"
-    sl_ff_sierra:       --profile sl_osx_sierra SL_BROWSER="firefox"
-    sl_chrome_sierra:   --profile sl_osx_sierra SL_BROWSER="chrome"
-    sl_safari_sierra:   --profile sl_osx_sierra SL_BROWSER="safari"
-
-    sl_osx_el_capitan:  --profile sl_desktop SL_OS="OS X 10.11"
-    sl_ff_el_cap:       --profile sl_osx_el_capitan SL_BROWSER="firefox"
-    sl_chrome_el_cap:   --profile sl_osx_el_capitan SL_BROWSER="chrome"
-    sl_safari_el_cap:   --profile sl_osx_el_capitan SL_BROWSER="safari"
+    browserstack: WEB_BROWSER=browserstack BS_USERNAME="<INSERT USER NAME HERE>" BS_AUTHKEY="<INSERT PASSWORD HERE>" TEST_CONTEXT="TestCentricity"
     
-    sl_osx_yosemite:    --profile sl_desktop SL_OS="OS X 10.10" RESOLUTION="1920x1200"
-    sl_ff_yos:          --profile sl_osx_yosemite SL_BROWSER="firefox"
-    sl_chrome_yos:      --profile sl_osx_yosemite SL_BROWSER="chrome"
-    sl_safari_yos:      --profile sl_osx_yosemite SL_BROWSER="safari"
+    # BrowserStack iOS real device native app profiles
+    bs_ios:           --profile browserstack --profile ios BS_OS=ios <%= mobile %>
+    bs_iphone:        --profile bs_ios DEVICE_TYPE=phone
+    bs_iphone13PM_15: --profile bs_iphone BS_OS_VERSION="15" BS_DEVICE="iPhone 13 Pro Max"
+    bs_iphone11_14:   --profile bs_iphone BS_OS_VERSION="14" BS_DEVICE="iPhone 11"
     
-    sl_osx_mavericks:   --profile sl_desktop SL_OS="OS X 10.9" RESOLUTION="1920x1200"
-    sl_ff_mav:          --profile sl_osx_mavericks SL_BROWSER="firefox"
-    sl_chrome_mav:      --profile sl_osx_mavericks SL_BROWSER="chrome"
-    sl_safari_mav:      --profile sl_osx_mavericks SL_BROWSER="safari"
-    
-    # SauceLabs Windows desktop browser profiles
-    sl_win7:            --profile sl_desktop SL_OS="Windows 7" RESOLUTION="1920x1200"
-    sl_win8:            --profile sl_desktop SL_OS="Windows 8.1" RESOLUTION="1280x1024"
-    sl_win10:           --profile sl_desktop SL_OS="Windows 10" RESOLUTION="1280x1024"
-    sl_ff_win7:         --profile sl_win7 SL_BROWSER="firefox"
-    sl_ff_win8:         --profile sl_win8 SL_BROWSER="firefox"
-    sl_ff_win10:        --profile sl_win10 SL_BROWSER="firefox"
-    sl_chrome_win7:     --profile sl_win7 SL_BROWSER="chrome"
-    sl_chrome_win8:     --profile sl_win8 SL_BROWSER="chrome"
-    sl_chrome_win10:    --profile sl_win10 SL_BROWSER="chrome"
-    
-    sl_ie11_win7:       --profile sl_win7 SL_BROWSER="internet explorer" SL_VERSION="11.0"
-    sl_ie10_win7:       --profile sl_win7 SL_BROWSER="internet explorer" SL_VERSION="10.0"
-    sl_ie9_win7:        --profile sl_win7 SL_BROWSER="internet explorer" SL_VERSION="9.0"
-    sl_ie11_win8:       --profile sl_win8 SL_BROWSER="internet explorer" SL_VERSION="11.0"
-    sl_ie11_win10:      --profile sl_win10 SL_BROWSER="internet explorer"
+    # BrowserStack Android real device native app profiles
+    bs_android: --profile browserstack --profile android BS_OS=android <%= mobile %>
+    bs_pixel5:  --profile bs_android BS_DEVICE="Google Pixel 5" BS_OS_VERSION="12.0" DEVICE_TYPE=phone
     
     
     #==============
-    # profiles for remotely hosted web browsers on the TestingBot service
+    # profiles for remotely hosted devices on the SauceLabs service
+    # WARNING: Credentials should not be stored as text in your cucumber.yml file where it can be exposed by anyone with access
+    #          to your version control system
     #==============
     
-    testingbot:         WEB_BROWSER=testingbot TB_USERNAME=<INSERT USER NAME HERE> TB_AUTHKEY=<INSERT PASSWORD HERE>
-    tb_desktop:         --profile testingbot <%= desktop %> RESOLUTION="1920x1200"
-    tb_mobile:          --profile testingbot <%= mobile %>
-    
-    # TestingBot OS X desktop browser profiles
-    tb_macos_sierra:    --profile tb_desktop TB_OS="SIERRA"
-    tb_ff_sierra:       --profile tb_macos_sierra TB_BROWSER="firefox"
-    tb_chrome_sierra:   --profile tb_macos_sierra TB_BROWSER="chrome"
-    tb_safari_sierra:   --profile tb_macos_sierra TB_BROWSER="safari" TB_VERSION="10"
-    
-    tb_osx_el_capitan:  --profile tb_desktop TB_OS="CAPITAN"
-    tb_ff_el_cap:       --profile tb_osx_el_capitan TB_BROWSER="firefox"
-    tb_chrome_el_cap:   --profile tb_osx_el_capitan TB_BROWSER="chrome"
-    tb_safari_el_cap:   --profile tb_osx_el_capitan TB_BROWSER="safari" TB_VERSION="9"
-    
-    tb_osx_yosemite:    --profile tb_desktop TB_OS="YOSEMITE"
-    tb_ff_yos:          --profile tb_osx_yosemite TB_BROWSER="firefox"
-    tb_chrome_yos:      --profile tb_osx_yosemite TB_BROWSER="chrome"
-    tb_safari_yos:      --profile tb_osx_yosemite TB_BROWSER="safari" TB_VERSION="8"
+    saucelabs: WEB_BROWSER=saucelabs SL_USERNAME="<INSERT USER NAME HERE>" SL_AUTHKEY="<INSERT PASSWORD HERE>" DATA_CENTER="us-west-1" AUTOMATE_PROJECT="TestCentricity - SauceLabs"
     
-    tb_osx_mavericks:   --profile tb_desktop TB_OS="MAVERICKS"
-    tb_ff_mav:          --profile tb_osx_mavericks TB_BROWSER="firefox"
-    tb_chrome_mav:      --profile tb_osx_mavericks TB_BROWSER="chrome"
-    tb_safari_mav:      --profile tb_osx_mavericks TB_BROWSER="safari" TB_VERSION="7"
+    # SauceLabs iOS real device native app profiles
+    sl_ios:           --profile saucelabs --profile ios SL_OS=ios <%= mobile %>
+    sl_iphone:        --profile sl_ios DEVICE_TYPE=phone
+    sl_iphone13PM_15: --profile sl_iphone SL_DEVICE="iPhone 13 Pro Max Simulator" SL_OS_VERSION="15.4"
     
-    # TestingBot Windows desktop browser profiles
-    tb_win7:            --profile tb_desktop TB_OS="WIN7"
-    tb_win8:            --profile tb_desktop TB_OS="WIN8"
-    tb_win10:           --profile tb_desktop TB_OS="WIN10"
-    tb_ff_win7:         --profile tb_win7 TB_BROWSER="firefox"
-    tb_ff_win8:         --profile tb_win8 TB_BROWSER="firefox"
-    tb_ff_win10:        --profile tb_win10 TB_BROWSER="firefox"
-    tb_chrome_win7:     --profile tb_win7 TB_BROWSER="chrome"
-    tb_chrome_win8:     --profile tb_win8 TB_BROWSER="chrome"
-    tb_chrome_win10:    --profile tb_win10 TB_BROWSER="chrome"
+    # SauceLabs Android real device native app profiles
+    sl_android: --profile saucelabs --profile android SL_OS=android <%= mobile %>
+    sl_pixel5:  --profile sl_android SL_DEVICE="Google Pixel 5 GoogleAPI Emulator" SL_OS_VERSION="12.0" DEVICE_TYPE=phone
     
-    tb_ie9_win7:        --profile tb_win7 TB_BROWSER="internet explorer" TB_VERSION="9"
-    tb_ie11_win8:       --profile tb_win8 TB_BROWSER="internet explorer" TB_VERSION="11"
-    tb_ie10_win8:       --profile tb_win8 TB_BROWSER="internet explorer" TB_VERSION="10"
-    tb_ie11_win10:      --profile tb_win10 TB_BROWSER="internet explorer" TB_VERSION="11"
-    tb_edge_win10:      --profile tb_win10 TB_BROWSER="microsoftedge" TB_VERSION="14"
     
-    # TestingBot iOS mobile browser profiles
-    tb_ios:              --profile tb_mobile TB_OS="MAC" TB_BROWSER="safari" TB_PLATFORM="iOS"
-    tb_iphone6s_plus_10: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 6s Plus"
-    tb_iphone6s_plus_93: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3"  TB_DEVICE="iPhone 6s Plus"
-    tb_iphone6_plus_10:  --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 6 Plus"
-    tb_iphone6_plus_93:  --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3"  TB_DEVICE="iPhone 6 Plus"
-    tb_iphone6s_10:      --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 6s"
-    tb_iphone6s_93:      --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3"  TB_DEVICE="iPhone 6s"
-    tb_iphone5s_10:      --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 5s"
-    tb_iphone5s_93:      --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3"  TB_DEVICE="iPhone 5s"
-    tb_ipad_pro_10:      --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="10.0" TB_DEVICE="iPad Pro"
-    tb_ipad_pro_93:      --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="9.3"  TB_DEVICE="iPad Pro"
-    tb_ipad_air2_10:     --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="10.0" TB_DEVICE="iPad Air 2"
-    tb_ipad_air2_93:     --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="9.3"  TB_DEVICE="iPad Air 2"
+    #==============
+    # profiles for remotely hosted devices on the TestingBot service
+    # WARNING: Credentials should not be stored as text in your cucumber.yml file where it can be exposed by anyone with access
+    #          to your version control system
+    #==============
     
+    testingbot: WEB_BROWSER=testingbot TB_USERNAME="<INSERT USER NAME HERE>" TB_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TestCentricity - TestingBot"
     
-    # TestingBot Android mobile browser profiles
-    tb_android:          --profile tb_mobile TB_OS="ANDROID" TB_BROWSER="browser" TB_PLATFORM="Android"
-    tb_nexus_s:          --profile tb_android TB_VERSION="6.0" TB_DEVICE="Nexus S"
-    tb_nexus_1:          --profile tb_android TB_VERSION="5.0" TB_DEVICE="Nexus 1"
-    tb_nexus_4:          --profile tb_android TB_VERSION="6.0" TB_DEVICE="Nexus 4"
-    tb_galaxy_nexus:     --profile tb_android TB_VERSION="4.4" TB_DEVICE="Galaxy Nexus"
-    tb_galaxy_s4:        --profile tb_android TB_VERSION="4.4" TB_DEVICE="Galaxy S4"
-    tb_galaxy_s5:        --profile tb_android TB_VERSION="5.0" TB_DEVICE="Galaxy S5"
-    tb_galaxy_s6:        --profile tb_android TB_VERSION="6.0" TB_DEVICE="Galaxy S6"
-
-
-To specify a locally hosted target browser using a profile at runtime, you use the flag `--profile` or `-p` followed by the profile name when
-invoking Cucumber in the command line. For instance, the following command invokes Cucumber and specifies that a local instance of Chrome
-will be used as the target web browser:
+    # TestingBot iOS real device native app profiles
+    tb_ios:               --profile testingbot --profile ios TB_OS=iOS <%= mobile %>
+    tb_iphone:            --profile tb_ios DEVICE_TYPE=phone
+    tb_iphone11_14_dev:   --profile tb_iphone TB_OS_VERSION="14.0" TB_DEVICE="iPhone 11" REAL_DEVICE=true
+    tb_iphone11_14_sim:   --profile tb_iphone TB_OS_VERSION="14.2" TB_DEVICE="iPhone 11"
+    tb_iphone13PM_15_sim: --profile tb_iphone TB_OS_VERSION="15.4" TB_DEVICE="iPhone 13 Pro Max"
     
-    $ cucumber -p chrome
+    # TestingBot Android real device native app profiles
+    tb_android:    --profile testingbot --profile android TB_OS=Android <%= mobile %>
+    tb_pixel_dev:  --profile tb_android TB_DEVICE="Pixel" TB_OS_VERSION="9.0" DEVICE_TYPE=phone REAL_DEVICE=true
+    tb_pixel6_sim: --profile tb_android TB_DEVICE="Pixel 6" TB_OS_VERSION="12.0" DEVICE_TYPE=phone
 
 
-The following command specifies that Cucumber will run tests against a local instance of Firefox, which will be used to emulate an iPad Pro
-in landscape orientation:
-    
-    $ cucumber -p ipad_pro -p landscape
-
+To specify a mobile simulator or real device target using a profile at runtime, you use the flag `--profile` or `-p` followed
+by the profile name when invoking Cucumber in the command line. For instance, the following command specifies that Cucumber will
+run tests against an iPad Pro (12.9-inch) (5th generation) with iOS version 15.4 in an XCode Simulator in portrait orientation:
 
-The following command specifies that Cucumber will run tests against an iPad Pro with iOS version 9.3 in an XCode Simulator
-in landscape orientation:
-    
-    $ cucumber -p ipad_pro_93_sim -p landscape
+    cucumber -p ipad_pro_12_15_sim -p portrait
     
     NOTE:  Appium must be running prior to executing this command
 
+You can ensure that Appium Server is running by including `-p run_appium` in your command line:
 
-The following command specifies that Cucumber will run tests against a remotely hosted Safari web browser running on an OS X Yosemite
-virtual machine on the BrowserStack service:
+    cucumber -p ipad_pro_12_15_sim -p portrait -p run_appium
 
-    cucumber -p bs_safari_yos
- 
 
-The following command specifies that Cucumber will run tests against a remotely hosted Mobile Safari web browser on an iPhone 6s Plus in
-landscape orientation running on the BrowserStack service:
+The following command specifies that Cucumber will run tests against a cloud hosted iPhone 13 Pro Max running iOS 15.4 on the
+BrowserStack service:
 
-    $ cucumber -p bs_iphone6_plus -p landscape
+    cucumber -p bs_iphone13PM_15
 
 
 
-## Web Test Automation Framework Implementation
+## Recommended Project Organization and Structure
 
- <img src="http://i.imgur.com/RvpxjzW.jpg" width="1024" alt="Web Framework Overview" title="Web Framework Overview">
+Below is an example of the project structure of a typical Cucumber based native mobile app test automation framework with a Screen
+Object Model architecture. `ScreenObject` class definitions should be stored in the `/features/support/<platform>/screens`
+folders, organized in functional area sub-folders as needed. Likewise, `ScreenSection` class definitions should be stored in
+the `/features/support/<platform>/sections` folder, where `<platform>` is typically `ios` or `android`.
 
+Common embedded WebViews for native and hybrid apps that are shared with both iOS and Android platforms should be stored in
+the `/features/support/shared_webviews` folder.
 
+    my_automation_project
+        ├── config
+        │   ├── locales
+        │   ├── test_data
+        │   └── cucumber.yml
+        ├── features
+        │   ├── step_definitions
+        │   ├── support
+        │   │   ├── android
+        |   |   |   ├── screens
+        |   |   |   └── sections
+        │   │   ├── ios
+        |   |   |   ├── screens
+        |   |   |   └── sections
+        │   │   ├── shared_webviews
+        │   │   ├── env.rb
+        │   │   ├── hooks.rb
+        │   │   └── world_pages.rb
+        ├── Gemfile
+        └── README.md
 
 
-## Copyright and License
+ <img src="https://i.imgur.com/DdoDOxV.jpg" alt="TestCentricity Native Mobile App Framework Overview" title="TestCentricity Native Mobile App Framework Overview">
 
-TestCentricity™ Framework is Copyright (c) 2014-2018, Tony Mrozinski.
-All rights reserved.
 
+### Combined native iOS/Android app and web app project
+
+If your native mobile apps share feature parity and a common user experience with a responsive web UI that is accessed via
+desktop/mobile web browsers, you can effectively create one set of Cucumber feature files and scenarios that can be used
+to test across all three platforms - iOS, Android, and web.
+
+Below is an example of the project structure of a typical Cucumber based native mobile app and web UI test automation framework
+with a Screen and Page Object Model architecture. `ScreenObject` class definitions should be stored in the `/features/support/<platform>/screens`
+folders, organized in functional area sub-folders as needed. Likewise, `ScreenSection` class definitions should be stored in
+the `/features/support/<platform>/sections` folder. `PageObject` class definitions should be stored in the `/features/support/web/pages`
+folders, organized in functional area sub-folders as needed, while `PageSection` class definitions should be stored in the
+the `/features/support/web/sections` folder.
 
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions
-are met:
+    my_automation_project
+        ├── config
+        │   ├── locales
+        │   ├── test_data
+        │   └── cucumber.yml
+        ├── features
+        │   ├── step_definitions
+        │   ├── support
+        │   │   ├── android
+        |   |   |   ├── screens
+        |   |   |   └── sections
+        │   │   ├── ios
+        |   |   |   ├── screens
+        |   |   |   └── sections
+        │   │   ├── web
+        |   |   |   ├── pages
+        |   |   |   └── sections
+        │   │   ├── env.rb
+        │   │   ├── hooks.rb
+        │   │   └── world_pages.rb
+        ├── Gemfile
+        └── README.md
 
-1. Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer.
 
-2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the following disclaimer in
-the documentation and/or other materials provided with the distribution.
+ <img src="https://i.imgur.com/uzFhvu4.jpg" alt="TestCentricity Native Mobile App and Web Framework Overview" title="TestCentricity Native Mobile App and Web Framework Overview">
 
-3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
 
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+## Copyright and License
+
+TestCentricity™ Framework is Copyright (c) 2014-2022, Tony Mrozinski.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
+OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.