testcentricity_web 2.1.8.2 → 2.1.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e678f8e881ffda2cf15a55d5a5e45c2f868aa0cb
-  data.tar.gz: 24b52c49cbdb7cb15e03752b3d189ebc65b96be4
+  metadata.gz: d9ce21fa3ed070540857f13c91d4e26737fafbb4
+  data.tar.gz: ec4148037d084b344a7b2f01fef0c6aaf1b97169
 SHA512:
-  metadata.gz: c7804f2f97c94e5c1c2e46b93d714450989ed9e0be070292b285bda3b7bb015fa21deb693314d6625a00675b80f0083083ccddeb9a2891e0334ab7ce53a325bb
-  data.tar.gz: ec65d387ce42c477d12491cc065cdcd0a04adaf9a7298d9f0e0021900d3aced5b0fd367ec9d1ec87e140ceba0177084e416f0544f45cf95798a5f0ae16be2922
+  metadata.gz: fe011d194b633020d0d3f5745e37984c1ca46f386e4c993b469bfd21afc6f09fea98829f3fe26db0b5896d57b76f1e4d5d5a8a53be0b4396a1c42acb76cc7ebb
+  data.tar.gz: a391da7ab4f408f181f36e31d225e9243751de034607dea79a84cf98f8a8d4d5a2a84b6a217ab2fe3a77165beff51bbe1845e87076a1a2f8203733977f42cfd5

data/.gitignore

@@ -0,0 +1,27 @@
+# OSX folder stuff
+.DS_Store
+Thumbs.db
+
+#IDE project files
+.idea
+.settings
+.project
+.idea/workspace.xml
+.idea/.rakeTasks
+*.iml
+
+doc/*
+.yardoc/*
+notes.txt
+coverage
+.bundle
+.ruby-version
+.ruby-gemset
+/my_templates
+
+Gemfile.lock
+
+
+.idea/testcentricity_web.iml
+
+.idea/.rakeTasks

data/.rubocop.yml

@@ -0,0 +1,41 @@
+# See full list of defaults here: https://github.com/bbatsov/rubocop/blob/master/config/default.yml
+# To see all cops used see here: https://github.com/bbatsov/rubocop/blob/master/config/enabled.yml
+
+Documentation:
+  Enabled: false
+
+AccessorMethodName:
+  Enabled: false
+
+TrivialAccessors:
+  Enabled: false
+
+RedundantReturn:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Encoding:
+  EnforcedStyle: when_needed
+
+Metrics/LineLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Style/RegexpLiteral:
+  Enabled: false
+
+Style/HashSyntax:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Style/EmptyLines:
+  Enabled: false

data/.yardopts

@@ -0,0 +1,2 @@
+--markup markdown
+--markup-provider redcarpet

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in testcentricity_web.gemspec
+gemspec
+
+gem 'redcarpet', :groups => [:development, :test]

data/LICENSE.txt

@@ -0,0 +1,28 @@
+TestCentricity Web (tm) Framework is Copyright (c) 2014-2017, 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.

data/README.md

@@ -0,0 +1,1438 @@
+# TestCentricity™ Web
+
+[![Gem Version](https://badge.fury.io/rb/testcentricity_web.svg)](https://badge.fury.io/rb/testcentricity_web)  [![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 Firefox or Chrome)
+* a "headless" browser (using Poltergeist and PhantomJS)
+* mobile Safari browsers on iOS device simulators (using Appium and XCode 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.
+
+
+**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).
+
+
+## What's New
+###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://github.com/grosser/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 or Firefox 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.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.
+
+
+## Installation
+
+Add this line to your automation project's Gemfile:
+
+    gem 'testcentricity_web'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install testcentricity_web
+
+
+## Setup
+###Using Cucumber
+
+If you are using Cucumber, you need to require the following in your *env.rb* file:
+
+    require 'capybara'
+    require 'capybara/cucumber'
+    require 'testcentricity_web'
+
+
+###Using RSpec
+
+If you are using RSpec instead, you need to require the following in your *env.rb* file:
+
+    require 'capybara'
+    require 'capybara/rspec'
+    require 'testcentricity_web'
+
+
+### Using Poltergeist
+
+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:
+
+    gem 'poltergeist'
+
+
+### 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
+
+
+
+## Page Objects
+
+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.
+
+**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.
+
+
+### 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
+    end
+
+
+    class HomePage < TestCentricity::PageObject
+    end
+
+
+    class RegistrationPage < TestCentricity::PageObject
+    end
+
+
+### Adding Traits to your Page Object
+
+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.
+
+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 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.
+
+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.
+
+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.
+
+You define your page's **Traits** as shown below:
+
+    class LoginPage < TestCentricity::PageObject
+      trait(:page_name)       { 'Login' }
+      trait(:page_url)        { '/sign_in' }
+      trait(:page_locator)    { 'body.login-body' }
+    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' }
+    end
+
+
+    class RegistrationPage < TestCentricity::PageObject
+      trait(:page_name)       { 'Registration' }
+      trait(:page_url)        { '/register' }
+      trait(:page_locator)    { 'body.registration' }
+    end
+
+
+### Adding UI Elements to your Page Object
+
+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:
+
+    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'
+    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
+
+
+### 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:
+
+    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
+
+      def remember_me(state)
+        remember_checkbox.set_checkbox_state(state)
+      end
+
+      # verify Login page default UI state
+      def verify_page_ui
+        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 }
+            }
+        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
+          }
+        populate_data_fields(fields)
+        sign_up_button.click
+      end
+    end
+
+
+
+Once your **Page Objects** have been instantiated, you can call your methods as shown below:
+
+    login_page.remember_me(true)
+    login_page.user_id_field.set('snicklefritz', 'Pa55w0rd')
+    
+
+
+## PageSection Objects
+
+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 **PageSection Object** may contain other **PageSection Objects**.
+
+
+### Defining a PageSection Object
+
+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:
+
+    class SearchForm < TestCentricity::PageSection
+    end
+
+
+### Adding Traits to a PageSection Object
+
+A **PageSection Object** typically has a root node object that encapsulates a collection of **UI Elements**. 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:
+
+    class SearchForm < TestCentricity::PageSection
+      trait(:section_locator)   { 'form#gnav-search' }
+      trait(:section_name)      { 'Search widget' }
+    end
+
+
+### Adding UI Elements to your PageSection Object
+
+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 PageSection Object
+
+You can add high level methods 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]'
+
+      def search_for(value)
+        search_field.set(value)
+        search_button.click
+      end
+    end
+
+
+### Adding PageSection Objects to your Page Object
+
+You add a **PageSection Object** to its associated **Page Object** 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
+    end
+
+Once your **Page Object** has been instantiated, you can call its **PageSection** methods as shown below:
+
+    home_page.search_form.search_for('ocarina')
+    
+    
+
+## 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.
+
+
+### Declaring and Instantiating UI Element
+
+Single **UIElement** declarations have the following format:
+                                     
+    elementType :element Name, locator
+
+* 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.
+
+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.
+
+### Example UI Element Declarations
+
+Supported **UI Element** 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
+      
+    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
+                   
+    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.
+
+
+### UIElement Inherited Methods
+
+With TestCentricity, all UI elements are based on the **UIElement** 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)
+
+**Object state methods:**
+
+    element.exists?
+    element.visible?
+    element.hidden?
+    element.enabled?
+    element.disabled?
+    element.get_value
+    element.get_attribute(attrib)
+    element.get_native_attribute(attrib)
+    
+**Waiting methods:**
+
+    element.wait_until_exists(seconds)
+    element.wait_until_gone(seconds)
+    element.wait_until_visible(seconds)
+    element.wait_until_hidden(seconds)
+    element.wait_until_value_is(value, seconds)
+    element.wait_until_value_changes(seconds)
+
+
+## Instantiating your Page Objects
+
+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**.
+
+One common implementation is shown below:
+
+    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
+    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.
+
+### Using the 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
+        }
+      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 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.
+
+
+### Leveraging the PageManager in your Cucumber tests
+
+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
+    
+      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)
+      target_page.load_page
+    end
+    
+    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
+      target_page = page_dispatcher(link_name)
+      target_page.navigate_to
+    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
+    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.
+
+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:
+
+    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
+    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
+    end
+
+
+
+## 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 Firefox or 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 Firefox or 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`                |`firefox` or `chrome` |1024 x 768 |landscape |iOS 10
+`ipad_pro`            |`firefox` or `chrome` |1366 x 1024|landscape |iOS 11
+`ipad_pro_10_5`       |`firefox` or `chrome` |1112 x 834 |landscape |iOS 11
+`ipad_chrome`         |`firefox` or `chrome` |1024 x 768 |landscape |iOS 10 - Mobile Chrome browser for iOS
+`android_tablet`      |`firefox` or `chrome` |1024 x 768 |landscape |Android 3.0
+`kindle_fire`         |`firefox` or `chrome` |1024 x 600 |landscape |
+`kindle_firehd7`      |`firefox` or `chrome` |800 x 480  |landscape |Fire OS 3
+`kindle_firehd8`      |`firefox` or `chrome` |1280 x 800 |landscape |Fire OS 5
+`kindle_firehd10`     |`firefox` or `chrome` |1920 x 1200 |landscape |Fire OS 5
+`surface`             |`firefox` or `chrome` |1366 x 768 |landscape |
+`blackberry_playbook` |`firefox` or `chrome` |1024 x 600 |landscape |BlackBerry Tablet OS
+`samsung_galaxy_tab`  |`firefox` or `chrome` |1280 x 800 |landscape |Android 4.0.4
+`google_nexus7`       |`firefox` or `chrome` |960 x 600  |landscape |Android 4.4.4
+`google_nexus9`       |`firefox` or `chrome` |1024 x 768 |landscape |Android 5.1
+`google_nexus10`      |`firefox` or `chrome` |1280 x 800 |landscape |Android 5.1
+`iphone`              |`firefox` or `chrome` |320 x 480  |portrait  |iOS 9.1
+`iphone4`             |`firefox` or `chrome` |320 x 480  |portrait  |iOS 9.1
+`iphone5`             |`firefox` or `chrome` |320 x 568  |portrait  |iOS 9.1
+`iphone6`             |`firefox` or `chrome` |375 x 667  |portrait  |iOS 9.1
+`iphone6_plus`        |`firefox` or `chrome` |414 x 736  |portrait  |iOS 9.1
+`iphone7`             |`firefox` or `chrome` |375 x 667  |portrait  |iOS 10
+`iphone7_plus`        |`firefox` or `chrome` |414 x 736  |portrait  |iOS 10
+`iphone7_chrome`      |`firefox` or `chrome` |375 x 667  |portrait  |iOS 10 - Mobile Chrome browser for iOS
+`iphone8`             |`firefox` or `chrome` |375 x 667  |portrait  |iOS 11
+`iphone8_plus`        |`firefox` or `chrome` |414 x 736  |portrait  |iOS 11
+`iphonex`             |`firefox` or `chrome` |375 x 812  |portrait  |iOS 11
+`android_phone`       |`firefox` or `chrome` |320 x 480  |portrait  |Android 4
+`nexus6`              |`firefox` or `chrome` |411 x 731  |portrait  |Android 6
+`pixel`               |`firefox` or `chrome` |411 x 731  |portrait  |Android 8
+`pixel_xl`            |`firefox` or `chrome` |411 x 731  |portrait  |Android 8
+`samsung_galaxy_s4`   |`firefox` or `chrome` |360 x 640  |portrait  |Android 5.0.1
+`samsung_galaxy_s5`   |`firefox` or `chrome` |360 x 640  |portrait  |Android 6.0.1
+`samsung_galaxy_s6`   |`firefox` or `chrome` |360 x 640  |portrait  |Android 6.0.1
+`windows_phone7`      |`firefox` or `chrome` |320 x 480  |portrait  |Windows Phone OS 7.5
+`windows_phone8`      |`firefox` or `chrome` |320 x 480  |portrait  |Windows Phone OS 8.0
+`lumia_950_xl`        |`firefox` or `chrome` |360 x 640  |portrait  |Windows Phone OS 10
+`blackberry_z10`      |`firefox` or `chrome` |384 x 640  |portrait  |BlackBerry 10 OS
+`blackberry_z30`      |`firefox` or `chrome` |360 x 640  |portrait  |BlackBerry 10 OS
+`blackberry_leap`     |`firefox` or `chrome` |360 x 640  |portrait  |BlackBerry 10 OS
+`blackberry_passport` |`firefox` or `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
+
+You can run your mobile web tests against the mobile Safari browser on simulated iOS devices using Appium and XCode on OS X. You must install XCode, the
+iOS version-specific device simulators for XCode, and Appium. You must ensure that the `appium_capybara` gem is installed and required as described in
+**section 2.4 (Setup - Using Appium)** above.
+
+Appium 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 `10.0`, `9.3`, `9.2`, 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`, `iPad Air 2`, etc.)
+`ORIENTATION`       | [Optional] Set to `portrait` or `landscape`
+`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_INITIAL_URL`   | [Optional] Initial URL, default is a local welcome page.  e.g.  `http://www.apple.com`
+`LOCALE`            | [Optional] Locale to set for the simulator.  e.g.  `fr_CA`
+
+
+
+### Remotely hosted desktop and mobile web browsers
+
+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`.
+
+
+#### Remote desktop browsers on the BrowserStack service
+
+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`)
+`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
+
+
+#### 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)
+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
+`TUNNELING`      | Must be `true` if you are testing against internal/local servers (`true` or `false`)
+`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
+`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
+`TUNNELING`   | Must be `true` if you are testing against internal/local servers (`true` or `false`)
+`ORIENTATION` | [Optional] Set to `portrait` or `landscape`
+
+
+### Using Browser specific Profiles in cucumber.yml
+
+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.
+
+
+    <% 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=firefox <%= mobile %>
+    ipad_pro:            WEB_BROWSER=ipad_pro            HOST_BROWSER=firefox <%= mobile %>
+    ipad_pro_10_5:       WEB_BROWSER=ipad_pro_10_5       HOST_BROWSER=firefox <%= mobile %>
+    ipad_chrome:         WEB_BROWSER=ipad_chrome         HOST_BROWSER=firefox <%= mobile %>
+    iphone:              WEB_BROWSER=iphone              HOST_BROWSER=firefox <%= mobile %>
+    iphone4:             WEB_BROWSER=iphone4             HOST_BROWSER=firefox <%= mobile %>
+    iphone5:             WEB_BROWSER=iphone5             HOST_BROWSER=firefox <%= mobile %>
+    iphone6:             WEB_BROWSER=iphone6             HOST_BROWSER=firefox <%= mobile %>
+    iphone6_plus:        WEB_BROWSER=iphone6_plus        HOST_BROWSER=firefox <%= mobile %>
+    iphone7:             WEB_BROWSER=iphone7             HOST_BROWSER=firefox <%= mobile %>
+    iphone7_plus:        WEB_BROWSER=iphone7_plus        HOST_BROWSER=firefox <%= mobile %>
+    iphone7_chrome:      WEB_BROWSER=iphone7_chrome      HOST_BROWSER=firefox <%= mobile %>
+    iphone8:             WEB_BROWSER=iphone8             HOST_BROWSER=firefox <%= mobile %>
+    iphone8_plus:        WEB_BROWSER=iphone8_plus        HOST_BROWSER=firefox <%= mobile %>
+    iphoneX:             WEB_BROWSER=iphonex             HOST_BROWSER=firefox <%= mobile %>
+    android_phone:       WEB_BROWSER=android_phone       HOST_BROWSER=firefox <%= mobile %>
+    nexus6:              WEB_BROWSER=nexus6              HOST_BROWSER=firefox <%= mobile %>
+    android_tablet:      WEB_BROWSER=android_tablet      HOST_BROWSER=firefox <%= mobile %>
+    kindle_fire:         WEB_BROWSER=kindle_fire         HOST_BROWSER=firefox <%= mobile %>
+    kindle_firehd7:      WEB_BROWSER=kindle_firehd7      HOST_BROWSER=firefox <%= mobile %>
+    kindle_firehd8:      WEB_BROWSER=kindle_firehd8      HOST_BROWSER=firefox <%= mobile %>
+    kindle_firehd10:     WEB_BROWSER=kindle_firehd10     HOST_BROWSER=firefox <%= tablet %>
+    surface:             WEB_BROWSER=surface             HOST_BROWSER=firefox <%= mobile %>
+    blackberry_playbook: WEB_BROWSER=blackberry_playbook HOST_BROWSER=firefox <%= mobile %>
+    samsung_galaxy_tab:  WEB_BROWSER=samsung_galaxy_tab  HOST_BROWSER=firefox <%= mobile %>
+    google_nexus7:       WEB_BROWSER=google_nexus7       HOST_BROWSER=firefox <%= mobile %>
+    google_nexus9:       WEB_BROWSER=google_nexus9       HOST_BROWSER=firefox <%= mobile %>
+    google_nexus10:      WEB_BROWSER=google_nexus10      HOST_BROWSER=firefox <%= mobile %>
+    samsung_galaxy_s4:   WEB_BROWSER=samsung_galaxy_s4   HOST_BROWSER=firefox <%= mobile %>
+    samsung_galaxy_s5:   WEB_BROWSER=samsung_galaxy_s5   HOST_BROWSER=firefox <%= mobile %>
+    samsung_galaxy_s6:   WEB_BROWSER=samsung_galaxy_s6   HOST_BROWSER=firefox <%= mobile %>
+    pixel:               WEB_BROWSER=pixel               HOST_BROWSER=firefox <%= mobile %>
+    pixel_xl:            WEB_BROWSER=pixel_xl            HOST_BROWSER=firefox <%= mobile %>
+    windows_phone7:      WEB_BROWSER=windows_phone7      HOST_BROWSER=firefox <%= mobile %>
+    windows_phone8:      WEB_BROWSER=windows_phone8      HOST_BROWSER=firefox <%= mobile %>
+    lumia_950_xl:        WEB_BROWSER=lumia_950_xl        HOST_BROWSER=firefox <%= mobile %>
+    blackberry_z10:      WEB_BROWSER=blackberry_z10      HOST_BROWSER=firefox <%= mobile %>
+    blackberry_z30:      WEB_BROWSER=blackberry_z30      HOST_BROWSER=firefox <%= mobile %>
+    blackberry_leap:     WEB_BROWSER=blackberry_leap     HOST_BROWSER=firefox <%= mobile %>
+    blackberry_passport: WEB_BROWSER=blackberry_passport HOST_BROWSER=firefox <%= mobile %>
+
+    
+    #==============
+    # profiles for mobile device screen orientation
+    #==============
+    
+    portrait:           ORIENTATION=portrait
+    landscape:          ORIENTATION=landscape
+    
+    
+    #==============
+    # 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
+    #==============
+    
+    appium_ios:            WEB_BROWSER=appium APP_PLATFORM_NAME="iOS" APP_BROWSER="Safari" <%= mobile %>
+    app_ios_93:            --profile appium_ios APP_VERSION="9.3"
+    app_ios_92:            --profile appium_ios APP_VERSION="9.2"
+    ipad_retina_93_sim:    --profile app_ios_93 APP_DEVICE="iPad Retina"
+    ipad_pro_93_sim:       --profile app_ios_93 APP_DEVICE="iPad Pro"
+    ipad_air_93_sim:       --profile app_ios_93 APP_DEVICE="iPad Air"
+    ipad_air2_93_sim:      --profile app_ios_93 APP_DEVICE="iPad Air 2"
+    ipad_2_93_sim:         --profile app_ios_93 APP_DEVICE="iPad 2"
+    iphone_6s_plus_93_sim: --profile app_ios_93 APP_DEVICE="iPhone 6s Plus"
+    iphone_6s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 6s"
+    iphone_5s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 5s"
+    iphone_4s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 4s"
+    
+    
+    #==============
+    # profiles for remotely hosted web browsers on the BrowserStack service
+    #==============
+    
+    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_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"
+    
+    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"
+    
+    # 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.1"
+    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_ie11_win8:       --profile bs_win8 BS_BROWSER="IE" BS_VERSION="11.0"
+    bs_ie10_win8:       --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="8.0" BS_BROWSER="IE" BS_VERSION="10.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="13.0"
+    
+    # BrowserStack iOS mobile browser profiles
+    bs_iphone:          --profile bs_mobile BS_PLATFORM=MAC BS_OS=ios BS_BROWSER=iPhone
+    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
+    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_mobile BS_BROWSER=iPhone BS_OS=ios BS_REAL_MOBILE="true"
+    bs_iphone7_plus:    --profile bs_iphone_device BS_DEVICE="iPhone 7 Plus"
+    bs_iphone7:         --profile bs_iphone_device BS_DEVICE="iPhone 7"
+    
+    # BrowserStack Android mobile browser profiles
+    bs_android:          --profile bs_mobile BS_PLATFORM=ANDROID BS_BROWSER=android BS_OS=android
+    bs_galaxy_s5:        --profile bs_android BS_DEVICE="Samsung Galaxy S5"
+    bs_kindle_fire_hd89: --profile bs_android BS_DEVICE="Amazon Kindle Fire HD 8.9"
+    bs_kindle_fire_hdx7: --profile bs_android BS_DEVICE="Amazon Kindle Fire HDX 7"
+    bs_kindle_fire2:     --profile bs_android BS_DEVICE="Amazon Kindle Fire 2"
+    bs_nexus7:           --profile bs_android BS_DEVICE="Google Nexus 7"
+    bs_nexus5:           --profile bs_android BS_DEVICE="Google Nexus 5"
+    bs_moto_razr:        --profile bs_android BS_DEVICE="Motorola Razr"
+    bs_sony_xperia:      --profile bs_android BS_DEVICE="Sony Xperia Tipo"
+    
+    # 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"
+    bs_google_pixel71:   --profile bs_android_device BS_DEVICE="Google Pixel" BS_OS_VERSION="7.1"
+    bs_nexus9:           --profile bs_android_device BS_DEVICE="Google Nexus 9"
+    bs_nexus6:           --profile bs_android_device BS_DEVICE="Google Nexus 6"
+    bs_galaxy_s7:        --profile bs_android_device BS_DEVICE="Samsung Galaxy S7"
+    bs_galaxy_s6:        --profile bs_android_device BS_DEVICE="Samsung Galaxy S6"
+    bs_galaxy_note4:     --profile bs_android_device BS_DEVICE="Samsung Galaxy Note 4"
+    
+    
+    #==============
+    # profiles for remotely hosted web browsers on the CrossBrowserTesting service
+    #==============
+    
+    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 CB_PLATFORM="iPhone6sPlus-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="1242x2208"
+    cb_iphone6s:        --profile cb_mobile CB_PLATFORM="iPhone6s-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="750x1334"
+    cb_iphone6_plus:    --profile cb_mobile CB_PLATFORM="iPhone6Plus-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="1242x2208"
+    cb_iphone6:         --profile cb_mobile CB_PLATFORM="iPhone6-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="750x1334"
+    cb_iphone5s:        --profile cb_mobile CB_PLATFORM="iPhone5s-iOS7sim" CB_BROWSER="MblSafari7.0" RESOLUTION="640x1136"
+    cb_ipad_pro:        --profile cb_mobile CB_PLATFORM="iPadPro-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2732x2048"
+    cb_ipad_air2:       --profile cb_mobile CB_PLATFORM="iPadAir2-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2048x1536"
+    cb_ipad_air:        --profile cb_mobile CB_PLATFORM="iPadAir-iOS8Sim" CB_BROWSER="MblSafari8.0" RESOLUTION="2048x1536"
+    cb_ipad_mini:       --profile cb_mobile 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"
+    
+    
+    #==============
+    # profiles for remotely hosted web browsers on the SauceLabs service
+    #==============
+    
+    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"
+    
+    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"
+    
+    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"
+    
+    
+    #==============
+    # profiles for remotely hosted web browsers on the TestingBot service
+    #==============
+    
+    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"
+    
+    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"
+    
+    # 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"
+    
+    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 TB_VERSION="10.0" TB_DEVICE="iPhone 6s Plus"
+    tb_iphone6s_plus_93: --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 6s Plus"
+    tb_iphone6_plus_10:  --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPhone 6 Plus"
+    tb_iphone6_plus_93:  --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 6 Plus"
+    tb_iphone6s_10:      --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPhone 6s"
+    tb_iphone6s_93:      --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 6s"
+    tb_iphone5s_10:      --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPhone 5s"
+    tb_iphone5s_93:      --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 5s"
+    tb_ipad_pro_10:      --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPad Pro"
+    tb_ipad_pro_93:      --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPad Pro"
+    tb_ipad_air2_10:     --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPad Air 2"
+    tb_ipad_air2_93:     --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPad Air 2"
+    
+    
+    # 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:
+    
+    $ cucumber -p chrome
+
+
+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
+
+
+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
+    
+    NOTE:  Appium must be running prior to executing this command
+
+
+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 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:
+
+    $ cucumber -p bs_iphone6_plus -p landscape
+
+
+
+## Web Test Automation Framework Implementation
+
+ <img src="http://i.imgur.com/RvpxjzW.jpg" width="1024" alt="Web Framework Overview" title="Web Framework Overview">
+
+
+
+
+## Copyright and License
+
+TestCentricity™ Framework is Copyright (c) 2014-2017, 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.