# User Guidelines
To ensure a smooth and secure experience when using applications integrated with the zkPass TransGate-SDK, please refer to the following platform-specific instructions and recommendations.
## 🖥️ Desktop (Windows / macOS)
**Recommended Setup:**
* **Browser**: Latest version of **Google Chrome** or **Brave**
* **Wallet**: [MetaMask](https://metamask.io/download/) browser extension (ensure it is installed, unlocked, and connected)
{% hint style="warning" %}
When you’re setting up a wallet, be sure to:
âś… Download and install only the latest version from their official source.
âś… Back up and keep your recovery phrases safe.
❌ Never share your recovery phrases with anyone, under any circumstances.
{% endhint %}
**Usage Instructions:**
**Option1: Install the** [**TransGate**](https://chrome.google.com/webstore/detail/zkpass-transgate/afkoofjocpbclhnldmmaphappihehpma?utm_source=ext_sidebar\&hl) **on Google Extension Store**
{% hint style="warning" %}
Please kindly note that **DON’T** install any **Transgate Extensions** obtained from third-party channels. This measure ensures that all installed extensions have undergone proper vetting and are up to our standards. Stick to [**official link** ](https://chrome.google.com/webstore/detail/zkpass-transgate/afkoofjocpbclhnldmmaphappihehpma?utm_source=ext_sidebar\&hl)and protect your personal accounts securely.
{% endhint %}
{% hint style="success" %}
**IMPORTANT!**
Please refrain from installing extensions from third-party sources. We cannot take responsibility for any problems that may occur as a result of installing such extensions. Stick to zkPass official link and trusted sources for a secure browsing experience.
{% endhint %}
1. Open the application link in your browser.
2. When prompted, approve the wallet connection via MetaMask.
3. Grant permissions for pop-ups and cross-site cookies (if disabled, verification flow may be blocked).
4. Log in the data source like usual, zkPass verification will run in-browser; please **do not close the tab** during the process.
{% hint style="warning" %}
**Notes:**
* **Ad blockers or privacy extensions** may interfere with wallet communication. Disable them temporarily if issues occur.
* Refresh the page if any UI components fail to load after connecting.
{% endhint %}
**Option2: Scan the QR Code and finish the process on mobile. 👇**
## 📱 iOS (iPhone)
**âś… Instant Access via App Clip (No App Installation Required)**
zkPass SDK is fully supported through Apple’s **App Clip** experience, offering a seamless and secure verification process with no installation needed.
**Instructions:**
1. Open the zkPass-integrated dApp link in **Safari** or scan the associated **QR code**.
2. An App Clip card will appear — tap **“Open”** to launch the zkPass verification flow.
3. You will be guided through wallet connection and data verification within the App Clip environment.
4. Complete the process and return to the main dApp. No persistent app or background services will remain.
**Requirements:**
* iOS 14.3 or later
* Safari or camera access (for QR codes)
* Ensure App Clips are enabled under iOS Settings → App Clips
{% hint style="warning" %}
**Notes:**
* Wallet connection will be handled in-session. MetaMask or WalletConnect will be triggered as needed.
* All processes are sandboxed and privacy-preserving per Apple’s App Clip policies.
{% endhint %}
## 📱 Android Devices
Required: Install [TransGate App](https://play.google.com/store/search?q=transgate\&c=apps) from Google Play Store
On Android, zkPass SDK operates via a native client—**TransGate**—to ensure secure communication and proof generation.
**âś… Recommended Method: Chrome Browser + MetaMask Mobile App**
1. Open the application link in Chrome or another Chromium-based browser.
2. Upon wallet connection request, select **MetaMask** or via WalletConnect.
3. Approve all requests in MetaMask and return to the original browser tab to complete verification.
**⚠️ MetaMask In-App Browser (Android):**
* Due to system-level restrictions, MetaMask’s in-app browser **does not fully support dApp redirects** or advanced authentication features.
* Use a standalone browser for better stability.
{% hint style="warning" %}
**The TransGate Android app currently supports Android 12 and above.**\
If your device isn’t compatible, using the Mise + TransGate extension is the recommended alternative below:
{% endhint %}
1. **Open Mise Browser**\
Download Mise from if you haven't already.
2. **Go to the Extension Page**\
Open this link in Mise:\
👉 [TransGate on Chrome Web Store](https://chromewebstore.google.com/detail/zkpass-transgate/afkoofjocpbclhnldmmaphappihehpma)
3. **Click "Add to Chrome"**\
Confirm the prompt and wait for the installation to finish.
4. **Verify Installation**\
After installation, you should see the TransGate icon in the top-right corner of your browser. Visit any zkPass-supported page to start using it.
{% hint style="danger" %}
***Important Reminder:*** to ensure the efficient use of computational and gas resources, it is advisable not to use multiple addresses to attest the same schema with the same account. Doing so will overwrite previous attestations, resulting in unnecessary resource consumption without yielding additional rewards.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.zkpass.org/user-guidelines.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
