# Guides overview

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

Pick the right kind of guide: use cases add one capability, Build your app takes a project to production, Services and infrastructure covers broadcasting and running a node or a service, and Examples are complete apps to copy from.

import GuideChooser from '/snippets/GuideChooser.jsx';

Use the guides to add the BSV blockchain to an app you are building. They run on testnet wherever a wallet is involved, so you can try them without real funds, except the guide that moves your app to Mainnet, which ends with real BitcoinSV (BSV). If you have not sent a payment yet, start with [Send a payment from a web app](https://bsvblockchain.com/docs/get-started/quick-start-browser/).

## Add one capability to your app

<GuideChooser />

| Guide | What you do |
|---|---|
| [Gate an API behind payments](https://bsvblockchain.com/docs/guides/payments/) | Charge for API routes with HTTP 402 Payment Required. |
| [Authenticate users with their wallet](https://bsvblockchain.com/docs/guides/identity-auth/) | Know which wallet sends each request to your Express API. |
| [Store data and files](https://bsvblockchain.com/docs/guides/data-storage/) | Put data in a transaction output through the user's wallet and read it back. |
| [Send messages between users](https://bsvblockchain.com/docs/guides/messaging/) | Send encrypted messages and payments with MessageBox (Holds each message until its recipient reads it). |
| [Track transactions with overlays](https://bsvblockchain.com/docs/guides/overlays/) | Index your app's transactions in an overlay (Built from topic managers, which decide what is admitted, and lookup services, which query what was admitted.) and look them up by service. |
| [Digital product passports on the BSV blockchain](https://bsvblockchain.com/docs/guides/digital-product-passports/) | Map a digital product passport onto the BSV blockchain and check a test passport offline. |

## Build your app

These guides take an app toward production, ending with the move to Mainnet:

<div className="cards-interactive">

**[Integrate the BSV blockchain with web frameworks](https://bsvblockchain.com/docs/guides/app-frameworks/)**

Add a wallet button to a Next.js or React app, send a payment and call an Express API that knows which wallet signed the request.

**[Request permissions and organize outputs](https://bsvblockchain.com/docs/guides/wallet-aware-apps/)**

Group the outputs your app creates with baskets, tags and labels, and know which permission windows BSV Desktop shows.

**[Move your app to Mainnet](https://bsvblockchain.com/docs/guides/go-to-mainnet/)**

Switch BSV Desktop and your server wallet from testnet to Mainnet, and get real BSV.

</div>

## Services and infrastructure

Your app sends its transactions through BSV Broadcaster, and each project documents how to run its own node or service:

<div className="cards-interactive">

**[Broadcast with BSV Broadcaster](https://bsvblockchain.com/docs/guides/services/broadcasting/)**

Pick an endpoint, send a signed transaction and follow it until it is mined.

**[Broadcasters, nodes and overlays](https://bsvblockchain.com/docs/guides/services/)**

Find the links to the docs of each node and service.

</div>

## Examples

The example apps are complete demos, each with its source code. Start from the one closest to what you are building, or see all of them in [Example apps](https://bsvblockchain.com/docs/showcase/):

<div className="cards-interactive">

**[P2P Medical](https://bsvblockchain.com/docs/showcase/p2p-medical/)**

Share an encrypted file between two wallet identities.

**[Time Anchor](https://bsvblockchain.com/docs/showcase/time-anchor/)**

Record the hash of a file on the blockchain and find it again.

**[BEEF Inspector](https://bsvblockchain.com/docs/showcase/beef-inspector/)**

Read a BEEF (Background Evaluation Extended Format (BRC-62)) payload and see the transaction inside it.

</div>

## Next steps

With the overview in hand, start with the guide that fits your app:

- [Send a payment from a web app](https://bsvblockchain.com/docs/get-started/quick-start-browser/)
- [Integrate the BSV blockchain with web frameworks](https://bsvblockchain.com/docs/guides/app-frameworks/)
- [Example apps](https://bsvblockchain.com/docs/showcase/)