context-bridge/FIREFOX_TEST_INSTRUCTIONS.md

🦊 Testing Context Bridge in Firefox

Good News!

Your extension should work in Firefox with minimal changes. Let's test it!

---

Step 1: Load Extension in Firefox

Open Firefox Debugging Page

1. Open Firefox
2. Navigate to: about:debugging#/runtime/this-firefox
3. Click "Load Temporary Add-on..."

Select Extension

1. Navigate to: /Users/alexa/context-bridge/extension
2. Select manifest.json file
3. Extension should load

---

Step 2: Configure Context URL

Same as Chrome:

1. Click the Context Bridge icon in toolbar
2. Paste a test GitHub Gist raw URL
3. Click "Save URL"

---

Step 3: Test on ChatGPT

1. Go to: https://chatgpt.com
2. Look for purple "Insert Context" button
3. Click it - should insert context message
4. Open DevTools (F12) - check Console

---

Quick Test Command

open -a Firefox "about:debugging#/runtime/this-firefox"

Then:

1. Click "Load Temporary Add-on..."
2. Select: /Users/alexa/context-bridge/extension/manifest.json

---

Firefox vs Chrome Differences

API Compatibility

Our extension uses:

• chrome.runtime ✅ Works in Firefox as browser.runtime (polyfilled)
• chrome.storage ✅ Works in Firefox
• Content scripts ✅ Works in Firefox
• Background service worker ⚠️ Firefox uses background scripts differently

Potential Issues

1. Service Worker (background.js)

   • Chrome: Uses Manifest V3 service workers
   • Firefox: Still prefers Manifest V2 background scripts
   • Solution: Create Firefox-specific manifest

2. Storage API

   • Should work the same
   • chrome.storage.sync works in Firefox

3. Content Scripts

   • Should work identically
   • Same DOM manipulation

---

Create Firefox Version (If Needed)

If you encounter issues, we can create a Firefox-specific version:

cd /Users/alexa/context-bridge

# Copy extension for Firefox version
cp -r extension extension-firefox

# Modify manifest for Firefox
cd extension-firefox
# Edit manifest.json to use Manifest V2

Manifest V2 Changes Needed

{
  "manifest_version": 2,
  "background": {
    "scripts": ["background/service-worker.js"]
  }
}

Instead of:

{
  "manifest_version": 3,
  "background": {
    "service_worker": "background/service-worker.js"
  }
}

---

Testing Checklist for Firefox

Visual Tests

• Extension loads without errors
• Popup UI renders correctly
• Button appears on ChatGPT
• Button appears on Claude
• Styling looks correct

Functional Tests

• Save URL works
• Button click inserts context
• Loading states work
• Success state appears
• Cache works (2nd click instant)

Firefox-Specific

• No manifest errors
• No API compatibility warnings
• Storage sync works
• Content scripts inject properly

---

Expected Compatibility

✅ Should Work Out of the Box:

• Content scripts (chatgpt.js, claude.js, etc.)
• Popup UI (popup.html, popup.js)
• Storage API
• Message passing

⚠️ Might Need Adjustments:

• Background service worker (Manifest V3 vs V2)
• Some Chrome-specific APIs

---

Quick Firefox Test

1. Load Extension:

   open -a Firefox "about:debugging#/runtime/this-firefox"
   

2. Click "Load Temporary Add-on"

3. Select:

   /Users/alexa/context-bridge/extension/manifest.json
   

4. Test on ChatGPT:

   https://chatgpt.com
   

5. Check Console (F12):

   Should see: "Context Bridge: Loaded on ChatGPT"
   

---

If It Works:

Great! Your extension is cross-browser compatible. You can publish to:

• ✅ Chrome Web Store
• ✅ Firefox Add-ons (addons.mozilla.org)

---

If It Doesn't Work:

Check Console for errors:

• Manifest version issues → Create Firefox-specific manifest
• Service worker issues → Use background scripts instead
• API issues → Use browser.* instead of chrome.*

---

Firefox Add-ons Submission

Once working in Firefox, you can submit to Firefox Add-ons:

1. Create account at addons.mozilla.org
2. Zip extension: zip -r context-bridge-firefox.zip extension/
3. Upload to Firefox Add-ons
4. Fill in listing details
5. Submit for review

Review time: Usually 2-5 days

---

Alternative: Create Firefox-Specific Build

If needed, I can create a separate Firefox version with:

• Manifest V2 compatibility
• browser.* API usage
• Firefox-optimized background script

Just let me know if you hit any issues!

---

Try loading it in Firefox now and see what happens! 🦊

Most likely it will "just work" since we used standard APIs.