To run the extension the following prerequisites need to be met:
- Google Chrome installed on the device
- Node.js installed (for running tests and developer mode)
Adding the extension to the browser can be done by following these steps:
- Download the zipped folder that includes a fully working build of the app as well as all of the extension’s code and assets.
- Head over to chrome://extensions and enable Developer mode by using a toggle in the top right corner of the screen.
- Click on "Load Unpacked" and navigate to the folder where downloaded the provided folder was unzipped.
- Navigate to the “build” directory, choose the chrome-mv3-prod folder and click select folder. Now, the extension should be enabled in Google Chrome. To make using the extension simpler, it is recommended to pin it to the extension toolbar.
Instructions for running tests:
- Ensure that Node.js is installed by running the command: node -v
- If it is not installed, do so by downloading it from this URL: https://nodejs.org/en/download
- Navigate to the unzipped folder with the projects code and run this command to install all dependencies: npm install
- To run the tests run the following command: npx playwright test
Instructions for running the project in development mode:
- Ensure that Node.js is installed by running the command: node -v
- If it is not installed, do so by downloading it from this URL: https://nodejs.org/en/download
- Navigate to the unzipped folder with the projects code and run this command to install all dependencies: npm install
- Head over to chrome://extensions and enable Developer mode by using a toggle in the top right corner of the screen.
- Click on "Load Unpacked" and navigate to the folder where downloaded the provided folder was unzipped.
- Navigate to the “build” directory, choose the chrome-mv3-dev folder and click select folder.
- To run the development server use the following command: npm run dev
If any changes are made in development, a new production build can be generated by the following command: npm run build This will generate a new chrome-mv3-prod directory which will hold the updated production build of the app.