initial commit

README.md

@@ -0,0 +1,99 @@
+# Firefox Proxy Switcher
+
+A Firefox extension that allows selective application of proxy servers to specific domains, providing flexible proxy management for different websites.
+
+## Features
+
+- **Domain-specific proxy configuration**: Apply different proxy settings to different domains
+- **Proxy profiles**: Save and reuse proxy configurations
+- **HTTP and SOCKS5 support**: Support for both HTTP and SOCKS5 proxy types
+- **Authentication support**: Username/password authentication for proxies
+- **Tag-based organization**: Organize domains with custom tags
+- **Quick toggle**: Enable/disable proxy for domains with one click
+
+## Security and Privacy
+
+This extension is designed with user privacy and security in mind:
+
+### Data Storage
+- All configuration data (domains, profiles, proxy settings) is stored locally in the browser using Firefox's `browser.storage.local` API
+- Proxy credentials (usernames/passwords) are encrypted and stored only in the local browser storage
+- No data is transmitted to external servers or collected by the extension
+
+### Network Permissions
+The extension requests the following permissions necessary for its functionality:
+
+- `proxy`: Required to configure and manage proxy settings
+- `storage`: Required to save user configuration locally
+- `tabs`: Required to determine the current domain when configuring proxy settings
+- `activeTab`: Required to access the current tab for configuration
+- `webRequest`: Required to handle proxy authentication requests
+- `webRequestBlocking`: Required to intercept and modify network requests for proxy routing
+- `<all_urls>`: Required to apply proxy settings to any website the user visits
+
+### How Proxy Routing Works
+1. When a user visits a website, the extension checks if that domain has proxy configuration
+2. If configured, the extension routes the traffic through the specified proxy server
+3. If not configured, traffic uses the direct connection (no proxy)
+4. Authentication credentials are only used when required by the proxy server and are transmitted securely
+
+### Security Considerations
+- **No data collection**: The extension does not collect, store, or transmit any browsing data
+- **Local-only storage**: All settings remain on the user's device
+- **Transparent operation**: Users can see exactly which domains use which proxies
+- **No external dependencies**: The extension works entirely offline once configured
+
+## Installation
+
+1. Download the extension package
+2. Open Firefox and navigate to `about:addons`
+3. Click the gear icon and select "Install Add-on From File"
+4. Select the downloaded extension file
+5. The extension will be installed and ready to use
+
+For Firefox Android, install the signed XPI from the extension's AMO page or use
+Firefox's self-distributed add-on installation flow. The manifest declares Android
+compatibility through `browser_specific_settings.gecko_android`; unsigned local
+packages are still rejected by Firefox's extension signing policy.
+
+### Advanced Settings
+
+Open **Advanced Settings** from the extension popup to manage all domains and
+profiles. The **Theme** selector supports **System**, **Light**, and **Dark** and
+is stored locally for use in both the options page and popup.
+
+## Usage
+
+### Basic Setup
+1. Click the Proxy Switcher icon in the Firefox toolbar
+2. Configure proxy settings for the current domain or access full settings
+
+### Advanced Configuration
+1. Right-click the extension icon and select "Options"
+2. Add proxy profiles for reuse across domains
+3. Configure domain-specific proxy settings
+4. Use tags to organize your proxy configurations
+
+## Permissions Explanation
+
+### Required Permissions
+- **proxy**: Allows the extension to configure Firefox's proxy settings
+- **storage**: Enables saving your proxy configurations locally
+- **tabs**: Lets the extension know which domain you're currently viewing
+- **activeTab**: Provides access to the currently active tab for configuration
+- **webRequest**: Handles authentication with proxy servers
+- **webRequestBlocking**: Intercepts and routes network requests through proxies
+- **<all_urls>**: Applies proxy settings to any website you visit
+
+All permissions are used solely for proxy management and do not enable data collection or tracking.
+
+## Support
+
+If you encounter issues or have questions:
+1. Check that all required permissions are granted
+2. Verify your proxy server settings are correct
+3. Ensure the proxy server is accessible from your network
+
+## Version
+
+Current version: 1.0.1