Percy's frontend web application, built with Ember.
First, install yarn.
PERCY_DEV_MIRAGE=yes yarn run start
Then, access http://localhost:4200
Using local API server
/etc/hosts to add a local hostname (required):
# Add this to /etc/hosts: 127.0.0.1 dev.percy.local
yarn run start
Using the production API
First, add the
dev.percy.local hostname above. Then, two environment variables must be set:
export PERCY_WEB_AUTH_TOKEN=... export PERCY_WEB_API_HOST=https://percy.io yarn run start
PERCY_WEB_AUTH_TOKEN is a full-access user token, different than the normal project
Then, access http://dev.percy.local:4200
Or, visit http://dev.percy.local:4200/tests.
Or, to run in
ember test --server mode:
yarn run test:server
Run tests locally with Percy enabled
PERCY_TOKEN=... PERCY_BRANCH=local yarn test
Update to a new ember.js version
Determine the version of Ember Percy's is currently using from the
ember-clipackage version in yarn.lock.
Determine the latest Ember release.
Read the changelog to review changes between the source version and target version.
View the release notes for each version between the source and target. If there are any unusual notes for an upgrade step, follow them.
Update using the Setup and Project Update notes for the current release.
When running the
dto do a diff on each file. Most changes can be ignored (
n). The package.json will have a few packages that need to have version numbers updated. Do these manually one by one. ember-cli-qunit doesn't need to be added.
yarn run testand make sure all tests pass. There might be deprecation warnings and breakages to fix.
After a CI build, ensure that the same number of screenshots have been taken, and that no unexpected visual diffs are present.