dylanfprice / alu-smile

ALU Smile

Donate to the Amazon Labor Union when you shop on Amazon.com.

Developing

Developing requires a recent version of nodejs with npm.

First install dependencies:

npm install

To just produce a build of the app run:

npm run build

This will run linting, tests, and output bundles to the dist/ directory.

Live Testing Environment

To start the live testing environment run:

npm run dev

Go to the address printed out by the server in your browser. You should see a sanitized version of the Amazon checkout page (this lives in the test-page/ folder).

As you make changes to the source code, the bundler will automatically rebuild the code.

Next you need to load the extension into your browser in development mode:

• Chrome
• Firefox

Finally, go back to the checkout page running on localhost. Open up the browser's web console and reload the page. You should see a log line saying "alu-smile loaded"

The workflow for making changes is:

• Edit code, save and it auto rebuilds
• Reload the extension according to your browser's process (i.e. click the reload button)
• Reload the checkout page

⚠️ The "Place your order" button on the test page will not send any requests to amazon.com, however it will open the actblue donation page and make a donation if you are logged in. You can avoid this by editing the donation url in the extension preferences, e.g. by setting it to https://example.com?amount=.

Project Site

There is a jekyll site located in the docs/ folder. It follows the standard github pages conventions so you can follow those docs, but what follows are brief instructions for working on it locally.

First you need ruby and bundler installed as specified here. Then

cd docs/
bundle install
bundle exec jekyll serve

Any changes pushed to main will go live.

alu-smile's Issues

Checkbox disappears when changing shipping method or other action on checkout page

Repro:

• Put some items in your shopping cart and proceed to the checkout page.
• Change shipping method.
• Page content reloads (async render not browser reload) and the ALU Smile checkbox disappears.

Expected:

• Checkbox remains after performing actions which reload content on the page.