Contributing

Contributing

Contributions are welcome! ReelScroller uses plain JavaScript with no build tools or bundlers, so the development workflow is straightforward.

---

Getting set up

1. Fork the repository on GitHub.
2. Clone your fork locally:

   git clone https://github.com/YOUR_USERNAME/ReelScroller.git
   cd ReelScroller

3. Load the extension as a temporary add-on (see Installation).

---

Development workflow

1. Make your changes to the source files.
2. Go to about:debugging#/runtime/this-firefox and click Reload next to Reel Scroller.
3. Refresh the Instagram tab to pick up the new content script.
4. Test your changes on https://www.instagram.com/reels/.

Repeat steps 1–4 until the change works as expected.

---

Code guidelines

Use the right content script file

File	Purpose
content_script.js	Working/development copy. Use this for experiments and debugging.
content_script_clean.js	Production copy loaded by Firefox. Only promote stable, tested code here.

Only content_script_clean.js is referenced in manifest.json. Changes to content_script.js have no effect until copied over.

Keep changes focused

• One logical change per pull request.
• If fixing a bug, describe what caused it and how your fix addresses it.
• If adding a feature, explain why it belongs in the extension.

Ad detection changes

If Instagram has changed its sponsorship label text or DOM structure, update the label array in content_script_clean.js and note the Instagram version/date in your PR description.

---

Submitting a pull request

1. Push your branch to your fork.
2. Open a pull request against the main branch of ToxcGang/ReelScroller.
3. Fill in the PR description with:
   • What the change does.
   • How to test it.
   • Any relevant Instagram UI context (if touching ad detection).

---

Reporting bugs

Open an issue and include:

• Firefox version.
• Extension version (visible in about:addons).
• Steps to reproduce.
• What you expected vs. what happened.