Simulating accessibility personas

Chrome extension for simulating the accessibility personas that were created by the UK Government Digital Service (GDS) and adapted by Germany's DigitalService GmbH des Bundes. This is a work in progress. Feedback and contributions are welcome.

The extension simulates various impairments (e.g, low vision, dyslexia) by injecting CSS and JS files to the currently active tab. Most CSS and JS files were taken directly from the GDS repo, some were slightly modified.

Usage

Select a persona from the extension and the current browser tab will be adjusted to simulate the persona's experience.

For some personas, you will need to install additional extensions at this point, or change your system settings (e.g., activate VoiceOver on your Mac). This is mentioned in the additional instructions for each persona.

Installation

1. Download this repository as a ZIP file. Unzip it.

2. Open Google Chrome and navigate to chrome://extensions/.

3. Activate "Developer mode" in the top-right corner.

4. Select "Load unpacked" and select the folder you downloaded from here.

5. Pin the extension (📍) to keep it visible.

Development

Install the project dependencies once using npm. To do that, Node.js needs to be installed on your machine. We recommend to use a version manager to handle Node.js versions, asdf with the asdf-nodejs plugin, for example.

npm install

Additionally, we use lefthook Git hooks which can be installed with brew:

brew install lefthook

Verify that your code changes are correctly formatted

Run npm run format:check and afterwards npm run format:fix to auto format your code changes with Prettier. A pre-commit lefthook Git hook will take care of checking your code before you can push it.

Build CSS with Tailwind

Use npm run tailwind to build the CSS file and watch for changes.

Contributing

Deutsche sprache weiter unten

Everyone is welcome to contribute! You can contribute by giving feedback, adding issues, answering questions, providing documentation or opening pull requests. Please always follow the guidelines and our Code of Conduct.

To contribute code, simply open a pull request with your changes and it will be reviewed by someone from the team. By submitting a pull request you declare that you have the right to license your contribution to the DigitalService and the community under the license picked by the project.

Mitwirken

Jede:r ist herzlich eingeladen, die Entwicklung der Project mitzugestalten. Du kannst einen Beitrag leisten, indem du Feedback gibst, Probleme beschreibst, Fragen beantwortest, die Dokumentation erweiterst, oder Pull-Requests eröffnest. Bitte befolge immer die Richtlinien und unseren Verhaltenskodex.

Um Code beizutragen erstelle einfach einen Pull Requests mit deinen Änderungen, dieser wird dann von einer Person aus dem Team überprüft. Durch das Eröffnen eines Pull-Requests erklärst du ausdrücklich, dass du das Recht hast deine Beitrag an den DigitalService und die Community unter der vom Projekt gewählten Lizenz zu lizenzieren.