> ## Documentation Index
> Fetch the complete documentation index at: https://reedai-07fa30f1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser and Device Compatibility

> Resolve compatibility issues across different browsers, devices, and operating systems in ZeroTwo

ZeroTwo works best on modern browsers and devices. If you experience display issues, missing features, or performance problems, your browser or device may need updating or configuration changes.

## Supported platforms

### Desktop browsers

<Tabs>
  <Tab title="✅ Fully supported">
    These browsers provide the best ZeroTwo experience:

    | Browser     | Minimum Version | Recommended   |
    | ----------- | --------------- | ------------- |
    | **Chrome**  | Version 100+    | Latest stable |
    | **Firefox** | Version 100+    | Latest stable |
    | **Safari**  | Version 15.4+   | Latest stable |
    | **Edge**    | Version 100+    | Latest stable |
    | **Brave**   | Version 1.40+   | Latest stable |
    | **Opera**   | Version 86+     | Latest stable |

    <Check>
      Most features work perfectly on these browsers when updated to recommended versions.
    </Check>
  </Tab>

  <Tab title="⚠️ Limited support">
    These browsers may have reduced functionality:

    * **Safari 14-15.3**: Some features limited
    * **Chrome/Firefox 90-99**: Older feature set
    * **Internet Explorer**: Not supported
    * **Legacy Edge**: Not supported

    <Warning>
      Using outdated browsers may cause display issues, missing features, or security vulnerabilities.
    </Warning>
  </Tab>

  <Tab title="Mobile browsers">
    Mobile browser support:

    | Platform    | Browser          | Support Level |
    | ----------- | ---------------- | ------------- |
    | **iOS**     | Safari 15.4+     | Full          |
    | **iOS**     | Chrome           | Full          |
    | **Android** | Chrome           | Full          |
    | **Android** | Firefox          | Full          |
    | **Android** | Samsung Internet | Partial       |

    <Info>
      Mobile experience is optimized for touch interfaces with responsive design.
    </Info>
  </Tab>
</Tabs>

### Operating systems

<AccordionGroup>
  <Accordion title="Windows">
    **Supported versions:**

    * Windows 11 (all versions)
    * Windows 10 (version 1909+)
    * Windows Server 2019+

    **Known issues:**

    * Windows 7/8: Limited browser support
    * Windows 10 older than 1909: May have performance issues

    **Recommendations:**

    * Keep Windows updated
    * Use Windows 11 for best performance
    * Enable hardware acceleration
  </Accordion>

  <Accordion title="macOS">
    **Supported versions:**

    * macOS Sonoma (14.0+)
    * macOS Ventura (13.0+)
    * macOS Monterey (12.0+)
    * macOS Big Sur (11.0+)

    **Known issues:**

    * macOS Catalina (10.15): Safari may have limitations
    * Older versions: Reduced feature support

    **Recommendations:**

    * Update to latest macOS version
    * Use Safari 15.4+ or latest Chrome/Firefox
    * Enable "Allow JavaScript" in Safari settings
  </Accordion>

  <Accordion title="Linux">
    **Supported distributions:**

    * Ubuntu 20.04 LTS or newer
    * Fedora 35 or newer
    * Debian 11 or newer
    * Arch Linux (current)
    * Other modern distros with updated browsers

    **Recommendations:**

    * Keep browser packages updated
    * Use official browser versions (not snap when possible)
    * Enable hardware acceleration if available
  </Accordion>

  <Accordion title="iOS and iPadOS">
    **Supported versions:**

    * iOS/iPadOS 15.4 or newer
    * iOS/iPadOS 16+ recommended

    **Known limitations:**

    * File upload size may be restricted
    * Some advanced features limited by iOS
    * Background processing restrictions

    **Recommendations:**

    * Update to latest iOS version
    * Use Safari or Chrome
    * Enable camera/microphone permissions when needed
  </Accordion>

  <Accordion title="Android">
    **Supported versions:**

    * Android 10 or newer
    * Android 12+ recommended

    **Recommendations:**

    * Use Chrome or Firefox
    * Keep system WebView updated
    * Enable JavaScript and cookies
  </Accordion>
</AccordionGroup>

## Common compatibility issues

<Steps>
  <Step title="Features not appearing">
    **Symptoms:**

    * Missing buttons or menus
    * Blank areas on page
    * Tools not loading

    **Solutions:**

    1. Update browser to latest version
    2. Clear browser cache and cookies
    3. Disable browser extensions temporarily
    4. Check JavaScript is enabled
    5. Try different browser

    <CodeGroup>
      ```bash Clear Chrome cache theme={null}
      1. Press Ctrl+Shift+Delete (Cmd+Shift+Delete on Mac)
      2. Select "All time"
      3. Check "Cached images and files"
      4. Click "Clear data"
      ```

      ```bash Clear Firefox cache theme={null}
      1. Press Ctrl+Shift+Delete (Cmd+Shift+Delete on Mac)
      2. Select "Everything"
      3. Check "Cache"
      4. Click "Clear Now"
      ```

      ```bash Clear Safari cache theme={null}
      1. Safari → Settings → Privacy
      2. Click "Manage Website Data"
      3. Search for "zerotwo.ai"
      4. Remove or Remove All
      ```
    </CodeGroup>
  </Step>

  <Step title="Display or layout problems">
    **Symptoms:**

    * Text overlapping
    * Misaligned elements
    * Mobile view on desktop
    * Zoom issues

    **Solutions:**

    1. **Reset zoom level**: Press Ctrl+0 (Cmd+0 on Mac)
    2. **Update browser**: Ensure latest version
    3. **Check display scaling**: System display settings should be 100-150%
    4. **Disable custom CSS**: Remove any user stylesheets
    5. **Try incognito mode**: Rules out extension conflicts

    <Tip>
      Browser zoom should be at 100% for optimal display. Use ZeroTwo's built-in text size controls instead.
    </Tip>
  </Step>

  <Step title="Performance issues">
    **Symptoms:**

    * Slow loading
    * Laggy interactions
    * Browser freezing
    * High CPU/memory usage

    **Solutions:**

    <Tabs>
      <Tab title="Enable hardware acceleration">
        **Chrome:**

        1. Settings → System
        2. Enable "Use hardware acceleration when available"
        3. Restart browser

        **Firefox:**

        1. Settings → General → Performance
        2. Uncheck "Use recommended performance settings"
        3. Enable "Use hardware acceleration when available"

        **Safari:**
        Hardware acceleration is enabled by default.
      </Tab>

      <Tab title="Reduce browser load">
        * Close unused tabs
        * Disable unnecessary extensions
        * Clear browser data regularly
        * Restart browser periodically
        * Update graphics drivers (Windows/Linux)
      </Tab>

      <Tab title="System optimization">
        **Windows:**

        ```powershell theme={null}
        # Check available RAM
        Get-ComputerInfo | Select-Object CsNumberOfProcessors, CsTotalPhysicalMemory

        # Close background apps in Task Manager
        ```

        **macOS:**

        ```bash theme={null}
        # Check memory pressure in Activity Monitor
        # Quit unused applications
        ```

        **Linux:**

        ```bash theme={null}
        # Check memory usage
        free -h

        # Kill memory-intensive processes if needed
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="File upload failures">
    **Symptoms:**

    * Files won't upload
    * Upload stuck at 0%
    * Unsupported file type errors

    **Solutions:**

    1. **Check file size**: Maximum 512MB per file
    2. **Verify file type**: See [supported formats](/troubleshooting/upload-errors)
    3. **Try different browser**: Some browsers handle uploads better
    4. **Disable extensions**: Ad blockers may interfere
    5. **Check network**: Ensure stable connection

    <Warning>
      On iOS, some file types may be restricted by system limitations. Try using Safari or accessing from desktop for full upload support.
    </Warning>
  </Step>
</Steps>

## Browser-specific issues

<AccordionGroup>
  <Accordion title="Safari issues">
    **Common problems:**

    * Intelligent Tracking Prevention blocking features
    * Private browsing limitations
    * WebKit-specific rendering issues

    **Solutions:**

    1. **Allow cookies from zerotwo.ai:**
       * Safari → Settings → Privacy
       * Uncheck "Prevent cross-site tracking" (or allow zerotwo.ai specifically)

    2. **Disable content blockers:**
       * Safari → Settings → Websites → Content Blockers
       * Set to "Off" for zerotwo.ai

    3. **Update Safari:**
       * System Settings → General → Software Update

    4. **Try Safari Technology Preview** for latest features

    <Info>
      Safari's privacy features are important but may occasionally interfere with web applications. Allowing specific sites maintains privacy while enabling functionality.
    </Info>
  </Accordion>

  <Accordion title="Firefox issues">
    **Common problems:**

    * Enhanced Tracking Protection blocking features
    * Container isolation issues
    * Add-on conflicts

    **Solutions:**

    1. **Adjust tracking protection:**
       * Click shield icon in address bar
       * Turn off "Enhanced Tracking Protection" for zerotwo.ai

    2. **Check container settings:**
       * If using containers, ensure zerotwo.ai isn't restricted

    3. **Test in Troubleshoot Mode:**
       * Help → Troubleshoot Mode
       * Disables all extensions temporarily

    4. **Update Firefox:**
       * Menu → Help → About Firefox
  </Accordion>

  <Accordion title="Chrome/Brave issues">
    **Common problems:**

    * Extension conflicts
    * Aggressive ad blocking
    * Site isolation issues

    **Solutions:**

    1. **Disable extensions one by one** to identify conflicts

    2. **Whitelist zerotwo.ai in ad blockers:**
       * Click extension icon
       * Add zerotwo.ai to whitelist

    3. **Check site settings:**
       * Click lock icon in address bar
       * Ensure JavaScript, cookies enabled

    4. **Reset Chrome settings** if issues persist:
       * Settings → Reset settings → Restore settings to original defaults
  </Accordion>

  <Accordion title="Mobile browser issues">
    **Common problems:**

    * Limited screen space
    * Touch interaction issues
    * Keyboard covering inputs
    * Auto-zoom on input focus

    **Solutions:**

    1. **Use landscape orientation** for complex interfaces
    2. **Update mobile OS and browser** to latest versions
    3. **Enable "Request Desktop Site"** if mobile view has issues
    4. **Ensure sufficient storage space** on device
    5. **Restart browser app** to clear temporary issues

    <Tip>
      For extended work sessions, consider using ZeroTwo on a desktop/laptop for the best experience. Mobile is great for quick interactions.
    </Tip>
  </Accordion>
</AccordionGroup>

## Accessibility features

ZeroTwo supports standard browser accessibility features:

### Keyboard navigation

* **Tab**: Navigate between elements
* **Enter/Space**: Activate buttons
* **Escape**: Close modals
* **Arrow keys**: Navigate lists and menus

<Check>
  All interactive elements are keyboard accessible for users who cannot use a mouse.
</Check>

### Screen readers

Tested with:

* **NVDA** (Windows)
* **JAWS** (Windows)
* **VoiceOver** (macOS/iOS)
* **TalkBack** (Android)

<Info>
  ARIA labels and semantic HTML ensure screen reader compatibility. Report any accessibility issues to our [support team](mailto:reed@zerotwo.ai).
</Info>

### Visual adjustments

Supports browser settings for:

* Custom font sizes
* High contrast mode
* Dark mode (system preference)
* Color blindness accommodations
* Reduced motion preferences

## Developer tools and debugging

<Accordion title="Check for console errors">
  Open browser developer tools to diagnose issues:

  <CodeGroup>
    ```text Chrome/Edge theme={null}
    Press F12 or Ctrl+Shift+I (Cmd+Option+I on Mac)
    Go to Console tab
    Look for red error messages
    ```

    ```text Firefox theme={null}
    Press F12 or Ctrl+Shift+I (Cmd+Option+I on Mac)
    Go to Console tab
    Check for errors
    ```

    ```text Safari theme={null}
    Enable developer menu:
      Safari → Settings → Advanced → Show Develop menu
    Then: Develop → Show JavaScript Console
    ```
  </CodeGroup>

  **Common errors to look for:**

  * JavaScript errors (red text)
  * Network failures (404, 500 errors)
  * CORS issues
  * WebSocket connection problems

  <Tip>
    Take a screenshot of console errors when reporting bugs - it helps support diagnose issues much faster.
  </Tip>
</Accordion>

## Testing compatibility

<Steps>
  <Step title="Verify browser version">
    Check you're using a supported browser version:

    1. **Chrome/Edge**: `chrome://version` or `edge://version`
    2. **Firefox**: `about:support`
    3. **Safari**: Safari → About Safari
    4. **Brave**: `brave://version`
  </Step>

  <Step title="Test in incognito/private mode">
    This tests without extensions or cached data:

    * **Chrome**: Ctrl+Shift+N (Cmd+Shift+N)
    * **Firefox**: Ctrl+Shift+P (Cmd+Shift+P)
    * **Safari**: File → New Private Window
    * **Edge**: Ctrl+Shift+N (Cmd+Shift+N)

    <Info>
      If ZeroTwo works in private mode but not regular mode, the issue is likely caused by an extension or cached data.
    </Info>
  </Step>

  <Step title="Try different browser">
    Test with a completely different browser to isolate browser-specific issues:

    1. Install alternative browser if needed
    2. Navigate to zerotwo.ai
    3. Log in and test functionality
    4. Compare behavior to primary browser
  </Step>

  <Step title="Update system and drivers">
    Ensure your system is fully updated:

    * **Windows**: Windows Update
    * **macOS**: Software Update
    * **Linux**: Package manager updates
    * **Graphics drivers**: Manufacturer website

    <Warning>
      Outdated graphics drivers can cause rendering issues and poor performance even with an updated browser.
    </Warning>
  </Step>
</Steps>

## Related pages

<CardGroup cols={2}>
  <Card title="Upload errors" icon="cloud-arrow-up" href="/troubleshooting/upload-errors">
    Troubleshoot file upload issues
  </Card>

  <Card title="Model timeouts" icon="clock" href="/troubleshooting/model-timeouts">
    Fix connection and timeout problems
  </Card>

  <Card title="Tools and permissions" icon="shield-check" href="/troubleshooting/tools-and-permissions">
    Resolve permission issues
  </Card>

  <Card title="Report a bug" icon="bug" href="/troubleshooting/report-a-bug">
    Report compatibility problems
  </Card>
</CardGroup>
