# Boomin Developers

Boomin docs: https://developers.boomin.ai

Core surfaces:
- Browser SDK and CLI package: `boominjs`
- Install: `npm install boominjs`
- Initialize app config: `npx boominjs init`
- Creator Connect API: https://api.boomin.ai/v1/connect
- Platform API: https://cloud.boomin.ai/api:xX_v8KtJ
- Connect OpenAPI: https://developers.boomin.ai/openapi/connect.yaml
- Platform OpenAPI: https://developers.boomin.ai/openapi/platform.yaml

Use public `pk_live_...` keys in browser code for Creator Connect.
Never expose private `sk_boomin_live_...` platform tokens in browser code.

Recommended Creator Connect flow:
1. `Boomin.init({ publicKey, programId, apiBase, redirectUri })`
2. `Boomin.requestOtp({ email, name })`
3. `Boomin.verifyOtp({ email, code })`
4. `Boomin.connectInstagram({ requireCreator: true })`
5. `Boomin.getConnectStatus(sessionId)`

CLI commands:
- `npx boominjs --help`
- `npx boominjs login`
- `npx boominjs init`
- `npx boominjs status --json`
- `npx boominjs scopes --json`
- `npx boominjs scopes explain units:create`
- `npx boominjs token create --name "Agent" --scopes org:read,units:read,units:create`
- `npx boominjs platform smoke --read-only --token sk_boomin_live_...`
- `npx boominjs platform smoke --write --cleanup --token sk_boomin_live_...`
- `npx boominjs platform smoke --all-scopes --cleanup --json`

Key docs:
- Quickstart: https://developers.boomin.ai/quickstart/
- Browser SDK: https://developers.boomin.ai/creator-connect/browser-sdk/
- Account-first flow: https://developers.boomin.ai/creator-connect/account-first/
- CLI guide: https://developers.boomin.ai/cli/
- Platform API: https://developers.boomin.ai/platform-api/
- Scope reference: https://developers.boomin.ai/tokens-scopes/scopes/
- API safety: https://developers.boomin.ai/tokens-scopes/safety/