> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/n4ze3m/page-assist/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Support

> Compatible browsers and feature availability for Page Assist

Page Assist supports multiple browsers with varying levels of feature compatibility. For the best experience, we recommend using the latest versions of Chrome, Edge, or Firefox.

## Supported Browsers

| Browser     | Sidebar | Chat With Webpage | Web UI | Notes                     |
| ----------- | ------- | ----------------- | ------ | ------------------------- |
| Chrome      | ✅       | ✅                 | ✅      | Full support, recommended |
| Brave       | ✅       | ✅                 | ✅      | Full support              |
| Firefox     | ✅       | ✅                 | ✅      | Full support, recommended |
| Vivaldi     | ✅       | ✅                 | ✅      | Full support              |
| Edge        | ✅       | ✅                 | ✅      | Full support, recommended |
| LibreWolf   | ✅       | ✅                 | ✅      | Full support              |
| Zen Browser | ✅       | ✅                 | ✅      | Full support              |
| Opera       | ❌       | ❌                 | ✅      | Web UI only               |
| Arc         | ❌       | ❌                 | ✅      | Web UI only               |

<Note>
  ✅ = Fully Supported | ❌ = Not Supported
</Note>

## Feature Availability

### Sidebar

The sidebar feature allows you to interact with your AI model from any webpage in a side panel.

**Fully Supported:**

* Chrome, Brave, Edge, Vivaldi (Chromium-based browsers with sidePanel API)
* Firefox, LibreWolf, Zen Browser (Firefox-based browsers)

**Not Supported:**

* Opera: Lacks proper sidePanel API implementation
* Arc: Limited extension API support

### Chat With Webpage

This feature enables contextual conversations about the current webpage content.

**Fully Supported:**

* All browsers with sidebar support
* Requires content script injection and DOM access

**Not Supported:**

* Opera and Arc: Same limitations as sidebar feature

### Web UI

The standalone web interface accessible by clicking the extension icon.

**Fully Supported:**

* All browsers listed above including Opera and Arc
* Works as a standard extension popup/new tab page

## Browser-Specific Details

### Chrome (Recommended)

* **Minimum Version:** Chrome 114+
* **Installation:** [Chrome Web Store](https://chrome.google.com/webstore/detail/page-assist/jfgfiigpkhlkbnfnbobbkinehhfdhndo)
* **Special Features:**
  * Chrome AI (Gemini Nano) support when available
  * Full sidePanel API support
  * YouTube auto-summarize feature (Beta)
* **Notes:** Best performance and feature completeness

### Brave

* **Minimum Version:** Brave 1.55+
* **Installation:** Install from Chrome Web Store
* **Special Features:**
  * Brave Search integration available
  * Privacy-focused browsing compatible
* **Notes:** Fully compatible as Chromium-based browser

### Firefox (Recommended)

* **Minimum Version:** Firefox 109+
* **Installation:** [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/page-assist/)
* **Special Features:**
  * Sidebar implementation using Firefox's native sidebar API
  * Enhanced privacy controls
* **Notes:**
  * Uses Manifest V2 (while Chrome uses V3)
  * YouTube auto-summarize not available
  * Full feature parity with Chromium version

### Edge

* **Minimum Version:** Edge 114+
* **Installation:** [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/page-assist-a-web-ui-fo/ogkogooadflifpmmidmhjedogicnhooa)
* **Special Features:** Same as Chrome (Chromium-based)
* **Notes:** Excellent compatibility and performance

### Vivaldi

* **Minimum Version:** Vivaldi 6.0+
* **Installation:** Install from Chrome Web Store
* **Notes:** Full compatibility as Chromium-based browser

### LibreWolf

* **Minimum Version:** Latest stable release recommended
* **Installation:** Install from Firefox Add-ons
* **Notes:**
  * Privacy-hardened Firefox fork
  * Full feature compatibility
  * May require adjusting some privacy settings

### Zen Browser

* **Minimum Version:** Latest stable release
* **Installation:** Install from Firefox Add-ons
* **Notes:** Firefox-based browser with full compatibility

### Opera (Limited Support)

* **Supported Features:** Web UI only
* **Installation:** May install from Chrome Web Store with limitations
* **Limitations:**
  * No sidebar support due to incomplete sidePanel API
  * Cannot use Chat with Webpage feature
  * Web UI and popup work normally

### Arc (Limited Support)

* **Supported Features:** Web UI only
* **Installation:** May work with Chrome Web Store extensions
* **Limitations:**
  * Restricted extension API access
  * No sidebar functionality
  * Web UI accessible through extension icon

## Installation Methods

### Official Browser Stores (Recommended)

1. **Chrome Web Store** - For Chrome, Brave, Edge, Vivaldi, and other Chromium browsers
2. **Firefox Add-ons** - For Firefox, LibreWolf, and Zen Browser
3. **Edge Add-ons** - Alternative source for Edge users

### Manual Installation (Development)

For testing or development purposes:

1. Clone the repository
2. Install dependencies with `bun install`
3. Build with `bun run build`
4. Load unpacked extension from the `build` directory

**Chrome/Chromium:**

* Navigate to `chrome://extensions`
* Enable "Developer mode"
* Click "Load unpacked"
* Select the `build` directory

**Firefox:**

* Navigate to `about:debugging#/runtime/this-firefox`
* Click "Load Temporary Add-on"
* Select `manifest.json` from the `build` directory

<Warning>
  Manual installations are temporary in Firefox and removed when the browser closes.
</Warning>

## Technical Requirements

### All Browsers

* **Storage:** Unlimited storage permission for chat history and knowledge base
* **Active Tab:** Access to current tab for Chat with Webpage
* **Scripting:** Content script injection for page analysis

### Chromium-Based (Chrome, Brave, Edge, Vivaldi)

* **Manifest:** V3
* **APIs:** sidePanel, declarativeNetRequest, action
* **Permissions:** storage, activeTab, scripting, contextMenus, tts, notifications

### Firefox-Based (Firefox, LibreWolf, Zen)

* **Manifest:** V2
* **APIs:** sidebar, browserAction, webRequest
* **Permissions:** storage, activeTab, scripting, contextMenus, notifications, webRequest, webRequestBlocking

## Performance Considerations

### Best Performance

* **Chrome/Edge on Desktop:** Optimal performance with Chrome AI support
* **Firefox on Desktop:** Excellent performance with privacy benefits

### Resource Usage

* **Memory:** Varies by AI provider and model size
* **Storage:** Depends on chat history and knowledge base size
* **CPU:** Higher during RAG indexing and local AI inference

## Feature Roadmap

### Planned Support

* Improved compatibility with Arc browser
* Safari support (under consideration)
* Mobile browser support (future release)

### Known Limitations

* **Opera:** Waiting for full sidePanel API implementation
* **Arc:** Limited by browser's extension architecture
* **Mobile:** Current version is desktop-only

## Reporting Issues

If you experience browser-specific issues:

1. Check the [GitHub Issues](https://github.com/n4ze3m/page-assist/issues)
2. Include your browser name and version
3. Describe the specific feature not working
4. Provide console error logs if available

## Recommendation Summary

**For Best Experience:**

* **Chrome** - Full features, Chrome AI support, best compatibility
* **Firefox** - Full features, enhanced privacy, excellent performance
* **Edge** - Full features, tight Windows integration

**For Privacy-Focused Users:**

* **Brave** - Chromium-based with privacy enhancements
* **LibreWolf** - Firefox-based with privacy hardening

**For Basic Usage:**

* **Opera/Arc** - Web UI works, but sidebar unavailable
