# Batiyao for developers

> Batiyao is a social app (batiyao.com, iPhone, Android) with its own points currency, BuckBuck. Developers can (1) connect apps and AI agents to people's Batiyao accounts with OAuth 2.1 + PKCE and the /v1 API, and (2) build mini apps: HTML5 games and tools that Batiyao hosts and runs sealed off from the internet.

## Mini apps

- [Mini apps specification (Markdown)](https://developer.batiyao.com/miniapps.md): the complete spec in one file — manifest, bundle and content rules with exact limits, the sandbox, the SDK, payments, sharing to posts, stories and chats, photos and videos the person picks, nicknames and data shared by every player, real-time multiplayer, Batiyao's on-device AI (BGen pictures, BAudio sounds, Batiyao AI answers) with capability versions, review, error codes, a working template and a checklist. Start here to build a mini app.
- [Mini apps (HTML)](https://developer.batiyao.com/miniapps): the same specification as a web page.
- [Mini app SDK](https://github.com/batiyao-app/developer-sample/blob/main/miniapp-sdk/batiyao-miniapp.js): batiyao-miniapp.js, one file to copy into the bundle.
- [Sample mini app: Wingbeat](https://github.com/batiyao-app/developer-sample/tree/main/miniapp/wingbeat): a complete game with storage and both kinds of purchase.
- [Simulator and packer](https://github.com/batiyao-app/developer-sample): `npm run miniapp` and `npm run pack:miniapp`.

## The API

- [Overview](https://developer.batiyao.com/): what the API offers and how to get a client id.
- [Guides](https://developer.batiyao.com/guides): connecting with OAuth 2.1 + PKCE, tokens, errors, posting, media, stories, chat.
- [Reference](https://developer.batiyao.com/reference): every /v1 endpoint.
- [Costs](https://developer.batiyao.com/costs): which calls spend the person's BuckBuck.
- [Sample app](https://github.com/batiyao-app/developer-sample): a complete "Connect with Batiyao" web app.