Setting up screener to run of a local dev environment

screener-setup.markdown

Pre-steps: Ensure your local webserver for you project is running on localhost at some port. This port will be reference later with ${PORT}.

1. Configure screener to run tests

1. Login to screener.io (Username and password will be provided through fugacious)
2. Once on the dashboard page, add a new Test Group
3. Name the group name anything you want
4. Set the baseurl to http://local.dev
5. Add a new browser
6. Add new pages

The last two options can be better understood by looking at the screener documentation and are not specific to setting it up locally.

2. Install screener tunnel client

1. Download the screener tunnel client at https://screener.io/docs/screener-tunnel
2. Unzip the downloaded file
3. Put the resulting folder either in the project directory or somewhere easy to access

3. Run the screener tunnel

1. Add the following entry to your /etc/hosts file (Note: editing this file requires root )

127.0.0.1 local.dev

2. Run the screener tunnel with the API key (The api key will be provided over fugacious)

./screener-tunnel-client -apikey="{API Key}" -host="local.dev:${PORT}"

4. Run the screener tests

1. Back on the screener dashboard, select your test group
2. Click "Run tests"