# Mushu

> Multi-tenant platform for authentication, push notifications, payments, media hosting, and engagement features. Simple REST APIs for iOS and web apps.

## Core Services

- **mushu-auth**: Apple Sign In (iOS + Web OAuth), Google Sign In, organizations, sessions
- **mushu-notify**: APNs push notifications, email via SES, device registration, delivery analytics
- **mushu-pay**: Prepaid wallet with Stripe, auto-refill, balance management
- **mushu-media**: Image hosting with auto-variants, video transcoding (MP4/WebM), zero egress via R2

## Utilities

- **mushu-geo**: Geohash encoding/decoding, distance calculations, radius search

## Engagement Services

- **mushu-streaks**: Activity tracking, streak calculation, timezone-aware daily streaks
- **mushu-leaderboards**: Boards, scores, rankings with pagination

## Getting Started

- [Quick Start](https://admin.mushucorp.com/docs/quickstart): 5-minute setup tutorial
- [API Keys](https://admin.mushucorp.com/docs/api-keys): Server API keys vs CLI tokens
- [CLI](https://admin.mushucorp.com/docs/cli): `pip install mushu-cli`
- [MCP](https://admin.mushucorp.com/docs/mcp): Connect to Claude, Cursor, AI tools

## Authentication

- [Apple Sign In](https://admin.mushucorp.com/docs/auth/apple): iOS and Web OAuth flows
- [Google Sign In](https://admin.mushucorp.com/docs/auth/google): Coming Q2 2026
- [Organizations](https://admin.mushucorp.com/docs/auth/orgs): Team management and roles
- [Sessions](https://admin.mushucorp.com/docs/auth/sessions): Token refresh and validation
- [Migration Guide](https://admin.mushucorp.com/docs/auth/migration): Move from self-hosted auth

## Push Notifications

- [Tenants](https://admin.mushucorp.com/docs/notify/tenants): Multi-app APNs configuration
- [Devices](https://admin.mushucorp.com/docs/notify/devices): Register iOS devices
- [Send Push](https://admin.mushucorp.com/docs/notify/send): Single and bulk notifications
- [Email](https://admin.mushucorp.com/docs/notify/email): SES integration
- [API Keys](https://admin.mushucorp.com/docs/notify/api-keys): Server-to-server auth

## Payments

- [Overview](https://admin.mushucorp.com/docs/pay/overview): How credits work
- [Tenants](https://admin.mushucorp.com/docs/pay/tenants): Connect Stripe account
- [Products](https://admin.mushucorp.com/docs/pay/products): Define credit packs
- [Customers](https://admin.mushucorp.com/docs/pay/customers): Balance management

## Media

- [Quick Start](https://admin.mushucorp.com/docs/media/quickstart): Upload first image in 5 minutes
- [Overview](https://admin.mushucorp.com/docs/media/overview): Architecture
- [Upload](https://admin.mushucorp.com/docs/media/upload): Direct uploads via presigned URLs
- [Images](https://admin.mushucorp.com/docs/media/images): Automatic variants and CDN
- [Videos](https://admin.mushucorp.com/docs/media/videos): Static MP4/WebM transcoding, zero egress

## Utilities

- [Geo](https://admin.mushucorp.com/docs/utilities/geo): Geohash encoding, distance calculations

## Engagement

- [Streaks](https://admin.mushucorp.com/docs/engage/streaks): Activity tracking, daily streaks
- [Leaderboards](https://admin.mushucorp.com/docs/engage/leaderboards): Boards, scores, rankings

## API Reference

- [Auth API](https://auth.mushucorp.com/docs): OpenAPI docs
- [Notify API](https://notify.mushucorp.com/docs): OpenAPI docs
- [Pay API](https://pay.mushucorp.com/docs): OpenAPI docs
- [Media API](https://media.mushucorp.com/docs): OpenAPI docs
- [Geo API](https://geo.mushucorp.com/docs): OpenAPI docs
- [Streaks API](https://streaks.mushucorp.com/docs): OpenAPI docs
- [Leaderboards API](https://leaderboards.mushucorp.com/docs): OpenAPI docs