# Developer Guides & Tutorials

- [Generating Mock Credentials](https://docs.humanity.org/developer-guides-and-tutorials/generating-mock-credentials.md): Create test credentials for development and testing. Mock data generation for SDK flows and on-chain verification without real palm scans.
- [SDK / API Guides](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides.md): Practical guides and code examples for integrating Humanity SDK into web applications with common use cases.
- [SDK Implementation Recipes & Patterns](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/sdk-implementation-recipes-and-patterns.md): Prerequisites, common integration patterns and best practices for SDK usage.
- [Frontend OAuth with the Connect SDK](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/frontend-oauth-with-the-connect-sdk.md): Build a React app that authenticates users with Humanity's OAuth flow and gates content based on biometric verification — using the Connect SDK directly without pre-built components.
- [Personalized Newsletter App - Reference Implementation](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/personalized-newsletter-app-reference-implementation.md): Full-stack reference application demonstrating Humanity SDK integration with user authentication, email verification, and personalized content delivery.
- [Personalized Newsletter App Overview](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/personalized-newsletter-app-reference-implementation/personalized-newsletter-app-overview.md): Complete architecture overview, repository links, high-level flow diagram, and prerequisites for the newsletter reference app.
- [Installing the App](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/personalized-newsletter-app-reference-implementation/installing-the-app.md): Step-by-step installation guide: clone repository, configure environment variables, install dependencies, set up OAuth credentials, and run locally.
- [Understanding the SDK Usage](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/personalized-newsletter-app-reference-implementation/understanding-the-sdk-usage.md): Code walkthrough explaining SDK initialization, authentication flow, callback handling, user data retrieval, and error handling in the newsletter app.
- [On-Chain Guides](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides.md): Practical guides for building decentralized applications with Humanity Protocol's on-chain verification infrastructure.
- [Connect Wallets](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/connect-wallets.md): Connect Web3 wallets to Humanity network for testnet and mainnet interactions.
- [Add Humanity Testnet to Metamask](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/connect-wallets/add-humanity-testnet-to-metamask.md): Configure MetaMask for Humanity testnet: network name, RPC URL, chain ID, currency symbol, and block explorer URL.
- [Add Humanity Mainnet to Metamask](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/connect-wallets/add-humanity-mainnet-to-metamask.md): Configure MetaMask for Humanity mainnet: network name, RPC URL, chain ID, currency symbol, and block explorer URL.
- [Fund Your Wallet](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/fund-your-wallet.md): Get testnet tokens and mainnet funds for deploying contracts and paying gas fees on Humanity network.
- [Fund Your Testnet Wallet](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/fund-your-wallet/fund-your-testnet-wallet.md): Request free testnet tokens from the faucet for development and testing. Includes faucet URL and usage instructions.
- [Fund Your Mainnet Wallet](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/fund-your-wallet/fund-your-mainnet-wallet.md): Acquire mainnet tokens via bridges, exchanges, or direct transfer for production smart contract deployment and gas fees.
- [Deploy an ERC-20 Token on Humanity Testnet using Hardhat](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/deploy-an-erc-20-token-on-humanity-testnet-using-hardhat.md): Complete tutorial: write, compile, test, deploy, and verify an ERC-20 token smart contract on Humanity testnet using Hardhat framework.
- [Verified Airdrop dApp - Reference Implementation](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/verified-airdrop-dapp-reference-implementation.md): Reference dApp demonstrating on-chain credential verification for token airdrops. Only verified humans can claim tokens using proof-of-humanity.
- [Verified Airdrop dApp Overview](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/verified-airdrop-dapp-reference-implementation/verified-airdrop-dapp-overview.md): Architecture overview, smart contract design, frontend integration, end-to-end verification flow, repository links, and setup prerequisites.
- [Smart Contracts Set Up](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/verified-airdrop-dapp-reference-implementation/smart-contracts-set-up.md): Deploy and configure verification oracle, airdrop contract, and credential checking logic for the verified airdrop dApp on testnet.
- [Front End Integration](https://docs.humanity.org/developer-guides-and-tutorials/on-chain-guides/verified-airdrop-dapp-reference-implementation/front-end-integration.md): Build React frontend that connects wallets, checks verification status, calls smart contract functions, and displays airdrop eligibility.


---

# 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.humanity.org/developer-guides-and-tutorials.md?ask=<question>
```

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.
