> For the complete documentation index, see [llms.txt](https://docs.humanity.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humanity.org/developer-guides-and-tutorials.md). # 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. - [Connect SDK](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/connect-sdk.md): Practical guides for integrating Humanity via @humanity-org/connect-sdk — OAuth and PKCE flows, token handling, and a full-stack reference app, for teams who want to own their own auth implementatio - [SDK Implementation Recipes & Patterns](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/connect-sdk/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/connect-sdk/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/connect-sdk/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/connect-sdk/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/connect-sdk/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/connect-sdk/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. - [React-SDK](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/react-sdk.md): Practical guides for integrating Humanity via @humanity-org/react-sdk — pre-built components and hooks that handle auth, routing protection, and content gating for you. - [React SDK Implementation Recipes & Patterns](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/react-sdk/react-sdk-implementation-recipes-and-patterns.md): Recipes for the React SDK: HumanityProvider config, HumanityGate patterns, popup vs redirect auth, protected routes, and token storage options. - [Verified Dashboard with the React SDK](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/react-sdk/verified-dashboard-with-the-react-sdk.md): Build a multi-page dashboard with popup sign-in, protected routes, and content gating using the React SDK — covers HumanityProvider, HumanityGate, and HumanityProfile in a Vite + React App - [Human First Content Platform App](https://docs.humanity.org/developer-guides-and-tutorials/sdk-api-guides/react-sdk/human-first-content-platform-app.md): Frontend reference app with four content tiers unlocked by verification presets — Palm Print, age, and accreditation — built entirely with the React SDK, no backend required. - [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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.humanity.org/developer-guides-and-tutorials.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.