Update gh-pages docs with correct Homebrew commands and troubleshooting

Author: puranjayjain

.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+    "workbench.colorCustomizations": {
+        "activityBar.activeBackground": "#96a516",
+        "activityBar.background": "#96a516",
+        "activityBar.foreground": "#15202b",
+        "activityBar.inactiveForeground": "#15202b99",
+        "activityBarBadge.background": "#abecf4",
+        "activityBarBadge.foreground": "#15202b",
+        "commandCenter.border": "#e7e7e799",
+        "sash.hoverBorder": "#96a516",
+        "statusBar.background": "#6d7810",
+        "statusBar.foreground": "#e7e7e7",
+        "statusBarItem.hoverBackground": "#96a516",
+        "statusBarItem.remoteBackground": "#6d7810",
+        "statusBarItem.remoteForeground": "#e7e7e7",
+        "titleBar.activeBackground": "#6d7810",
+        "titleBar.activeForeground": "#e7e7e7",
+        "titleBar.inactiveBackground": "#6d781099",
+        "titleBar.inactiveForeground": "#e7e7e799"
+    },
+    "peacock.color": "#6d7810"
+}

docs/homebrew-integration.md

@@ -21,15 +21,17 @@ Homebrew is a package manager for macOS that simplifies the installation of soft
 
 ```bash
 # Add the tap and install
-brew tap sapireli/airprint-bridge
+brew tap sapireli/AirPrint_Bridge https://github.com/sapireli/AirPrint_Bridge.git
 brew install airprint-bridge
 ```
 
+**Note**: The explicit HTTPS URL ensures the tap works without requiring git authentication credentials, even though the repository is public.
+
 ### Step-by-Step Installation
 
 1. **Add the tap** (if not already added):
    ```bash
-   brew tap sapireli/airprint-bridge
+   brew tap sapireli/AirPrint_Bridge https://github.com/sapireli/AirPrint_Bridge.git
    ```
 
 2. **Install AirPrint Bridge**:
@@ -75,6 +77,39 @@ brew uninstall airprint-bridge
 - Automatic formula validation
 - Consistent installation experience
 
+## Troubleshooting
+
+### Git Authentication Issues
+
+If you encounter git authentication prompts when tapping:
+
+```bash
+# Force HTTPS instead of SSH
+git config --global url."https://github.com/".insteadOf git@github.com:
+
+# Clear any cached credentials
+git config --global --unset credential.helper
+
+# Then try tapping again
+brew tap sapireli/AirPrint_Bridge https://github.com/sapireli/AirPrint_Bridge.git
+```
+
+### Alternative Tapping Method
+
+If you continue to have issues, you can also clone and tap locally:
+
+```bash
+# Clone the repository
+git clone https://github.com/sapireli/AirPrint_Bridge.git
+cd AirPrint_Bridge
+
+# Tap from local directory
+brew tap sapireli/AirPrint_Bridge .
+
+# Install
+brew install airprint-bridge
+```
+
 ## Using AirPrint Bridge with Homebrew
 
 ### Command Reference

docs/installation.md

@@ -44,7 +44,7 @@ Homebrew provides the easiest and most reliable installation method:
 
 ```bash
 # Add the tap and install
-brew tap sapireli/airprint-bridge
+brew tap sapireli/AirPrint_Bridge https://github.com/sapireli/AirPrint_Bridge.git
 brew install airprint-bridge
 ```