For some operating systems, enabling control of screen readers is tightly controlled.
To make environment setup easier
@guidepup/setup was created to handle the setup of your OS for you. Run the setup with:
- CI / CD
npx @guidepup/setup --ci
The CLI will first attempt to configure your environment itself, but on systems with tighter security controls such as MacOS with System Integrity Protection (SIP), it may prompt you for additional inputs so that it can complete setup through UI automation.
Recording Setup (MacOS Only)
If you are encountering errors in CI for MacOS you can pass a
--record flag to the command which will output a screen-recording of the setup to a
./recordings/ folder within the current working directory.
- CI / CD
npx @guidepup/setup --record
npx @guidepup/setup --ci --record
guidepup/setup-action step to enable screen reader test automation in GitHub CI:
- name: Guidepup Setup
If you are encountering issues with
@guidepup/setup then please reach out and raise a GitHub issue.