Known Issues

Known Issues

Current limitations, known issues, and workarounds for the Accessibility Widget.

⚠️ Current Limitations

Text-to-Speech

Firefox Limitations

Issue: Firefox has limited TTS support compared to Chrome/Safari.

Impact:

• Limited voice selection
• Some TTS parameters may not work as expected
• Word highlighting may be less accurate

Workaround:

• TTS still works for basic text reading
• Use Chrome, Edge, or Safari for full TTS features
• Basic functionality is still available in Firefox

Status: Browser limitation, not a plugin bug

---

Color Blindness Filters

Performance on Large Pages

Issue: Color blindness filters may slow down pages with many images.

Impact:

• Slight performance impact on pages with 50+ images
• May cause minor lag on very large pages

Workaround:

• Optimize images on your website
• Consider disabling filters on pages with many images
• Use filters only when needed

Status: Known limitation, optimization in progress

Widget Visibility

Issue: Widget may disappear when color blindness filters are applied (fixed in recent versions).

Impact:

• Widget not visible with filters active

Workaround:

• Update to latest version
• Widget should remain visible with proper CSS isolation

Status: Fixed in version 1.0.0+

---

localStorage

Private/Incognito Mode

Issue: Settings may not persist in some browsers' private/incognito modes.

Impact:

• Settings reset when private session ends
• Settings may not save in private mode

Workaround:

• Use normal browsing mode for persistent settings
• Settings will work during the session
• This is a browser security feature

Status: Browser behavior, not a bug

Storage Limits

Issue: localStorage has size limits (typically 5-10MB).

Impact:

• Very unlikely to be an issue
• Plugin uses minimal storage (< 1KB)

Workaround:

• Not applicable (plugin uses minimal storage)

Status: Not a concern for this plugin

---

Browser Compatibility

Internet Explorer

Issue: Internet Explorer is not supported.

Impact:

• Plugin will not work in IE
• IE is deprecated by Microsoft

Workaround:

• Use modern browsers (Chrome, Firefox, Safari, Edge)
• IE users should upgrade to Edge

Status: IE is deprecated, not supported

Older Browser Versions

Issue: Browsers older than minimum versions may not work correctly.

Impact:

• Some features may not work
• Widget may not appear
• Errors may occur

Workaround:

• Update browser to latest version
• Use supported browsers

Status: Use modern browsers

---

🐛 Known Bugs

None Currently

There are no known bugs at this time. If you find a bug, please report it on GitHub Issues.

---

🔧 Workarounds

TTS Not Working

Problem: TTS doesn't work in Firefox.

Workaround:

• Use Chrome, Edge, or Safari for full TTS support
• Basic TTS still works in Firefox

Settings Not Persisting

Problem: Settings reset in private/incognito mode.

Workaround:

• Use normal browsing mode
• Settings work during the session

Widget Not Visible with Filters

Problem: Widget disappears with color blindness filters.

Workaround:

• Update to latest version
• Check custom CSS isn't interfering

Performance Issues

Problem: Page slows down with filters.

Workaround:

• Optimize images
• Disable filters if not needed
• Use CDN version for better caching

---

📋 Browser-Specific Issues

Firefox

• Limited TTS support
• Some TTS features may not work
• Other features work normally

Safari

• No known issues
• Full feature support

Chrome/Edge

• No known issues
• Full feature support

Mobile Browsers

• TTS may require user interaction
• Some features may behave slightly differently
• Generally works well

---

🔄 Planned Fixes

Upcoming Improvements

1. Performance Optimization

   • Optimize color blindness filters
   • Reduce performance impact

2. Enhanced TTS

   • Better Firefox support (if possible)
   • More voice options

3. Additional Features

   • More customization options
   • Additional accessibility features

---

📝 Reporting Issues

If you encounter an issue not listed here:

1. Check Browser Console

   • Open DevTools (F12)
   • Look for errors
   • Note error messages

2. Test in Different Browser

   • Try Chrome, Firefox, Safari
   • Isolate browser-specific issues

3. Report on GitHub

   • Include browser and version
   • Include steps to reproduce
   • Include console errors
   • Include screenshots if applicable

Issue Report Template

**Description:**
Clear description of the issue

**Browser and Version:**
Chrome 120, Firefox 121, etc.

**Steps to Reproduce:**
1. Step one
2. Step two

**Expected Behavior:**
What should happen

**Actual Behavior:**
What actually happens

**Console Errors:**
Any JavaScript errors

**Screenshots:**
If applicable

---

🆘 Getting Help

• Check Troubleshooting guide
• Review FAQ
• Check Browser Compatibility
• Open issue on GitHub

---

📚 Related Pages

• Troubleshooting
• Browser Compatibility
• FAQ

---

Last Updated: November 2025

If you find a bug, please report it! 🐛