# CrackPay Mini Apps

> Developer documentation for building web apps that run inside CrackPay, the USD stablecoin wallet on Arc.

AI coding assistants: read [SKILL.md](/developers/SKILL.md) first. It has every rule and code pattern in one file.

Installable skills: [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json) (`npx skills add https://crackpay.vercel.app`), or the repository https://github.com/crackedstudio/crackpay-skills.

## Getting started

- [Overview](/developers/overview.md): What a Mini App is, how it talks to the wallet, network details.
- [Quick start](/developers/quick-start.md): Add the SDK, connect, read a balance, send a transaction.
- [Test in CrackPay](/developers/test-in-crackpay.md): Developer mode, loading a test page, tunnelling a local server.

## Guides

- [Wallet connection](/developers/wallet-connection.md): The provider, auto-connect, wagmi, smart-account caveats.
- [Transactions and balances](/developers/transactions.md): Arc's USDC decimals, sending, token rules, errors.
- [UI and container](/developers/ui-and-container.md): Frame size, what the sandbox allows, storage, navigation.
- [Get listed](/developers/listing.md): The listing file, requirements, review, what happens after.
- [Submit a Mini App](/developers/submit): The submission form.

## Reference

- [Reference](/developers/reference.md): Supported methods, events, error codes, limits.
- [npm package](https://www.npmjs.com/package/@crackpay/miniapp-sdk): `@crackpay/miniapp-sdk`, with `/viem` and `/react` entry points.
- [SDK script](/miniapp-sdk.js): The same SDK as a script tag, for pages without a bundler.