# Foony Realtime

> Foony Realtime is a managed realtime platform: pub/sub messaging over WebSocket channels, with presence, message history, end-to-end encryption, live Postgres query sync, and a Pusher-compatible API. SDKs for JavaScript/TypeScript and Go, plus a REST API for everything else.

Every docs page is also served as plain markdown: append `.md` to its URL. The links below point at the markdown versions.

## Getting started

- [Quickstart](https://foony.io/docs/getting-started.md): From API key to a live subscription in a few minutes.
- [React](https://foony.io/docs/getting-started/react.md): One shared client, subscriptions in effects, presence as state.
- [Next.js](https://foony.io/docs/getting-started/nextjs.md): A token route handler on the server, live client components in the browser.
- [Laravel](https://foony.io/docs/getting-started/laravel.md): Laravel broadcasting on Foony with the Pusher driver, from zero.

## Guides

- [Publish and subscribe](https://foony.io/docs/publish-subscribe.md): Fan out events over channels, including ephemeral messages.
- [Channels](https://foony.io/docs/channels.md): Naming, lifecycle states, attach and release, and channel options.
- [Presence](https://foony.io/docs/presence.md): Track who is on a channel and react to joins and leaves.
- [History](https://foony.io/docs/history.md): Replay stored messages so clients recover after reconnects.
- [Channel rules](https://foony.io/docs/channel-rules.md): Per-prefix persistence: store history, stay live-only, or keep a last value.
- [Connections](https://foony.io/docs/connections.md): The connection lifecycle, reconnection, and what the SDK restores.
- [Database Sync](https://foony.io/docs/database-sync.md): Connect your Postgres and give clients live query results as documents.
- [Pusher and Laravel](https://foony.io/docs/pusher.md): Point Laravel Echo and any Pusher client at Foony with only environment variables.
- [Auth and capabilities](https://foony.io/docs/auth.md): API keys, short-lived tokens, and channel-scoped permissions.
- [Encryption](https://foony.io/docs/encryption.md): End-to-end encrypt payloads with a key the service never sees.

## Chat

- [Chat](https://foony.io/docs/chat.md): Add in-app chat that rides your existing realtime connection.
- [Messages](https://foony.io/docs/chat/messages.md): Send, edit, and delete messages, and load the backlog.
- [Typing, reactions, and presence](https://foony.io/docs/chat/rooms.md): Typing indicators, ephemeral reactions, presence, and occupancy.

## Platform

- [Apps and API keys](https://foony.io/docs/platform/apps-and-keys.md): Projects, apps, key management, rotation, and team roles.
- [Usage and billing](https://foony.io/docs/platform/usage-and-billing.md): What counts as a message, usage charts, plans, and overage.
- [Monitoring](https://foony.io/docs/platform/monitoring.md): Live app stats and the per-connection inspector in the dashboard.
- [How it works](https://foony.io/docs/platform/how-it-works.md): The design behind ordering, exactly once delivery, and recovery.
- [Browser behavior](https://foony.io/docs/browser-behavior.md): Tabs, unloads, background pages, and presence timing in browsers.
- [Building with LLMs](https://foony.io/docs/llms.md): Point coding agents at llms.txt and the Markdown docs.

## Reference

- [JavaScript SDK](https://foony.io/docs/sdks/javascript.md): The full browser and Node client API.
- [Go SDK](https://foony.io/docs/sdks/go.md): The full Go client API for backends and services.
- [Server auth](https://foony.io/docs/sdks/server.md): Mint scoped client tokens from your backend.
- [Protocol](https://foony.io/docs/protocol.md): How clients connect, and why the wire format is SDK-only.
- [REST API](https://foony.io/docs/rest-api.md): Publish, history, presence, and token minting over plain HTTPS.
- [Errors](https://foony.io/docs/errors.md): The error envelope, every error code, and WebSocket close codes.
- [Limits](https://foony.io/docs/limits.md): Message sizes, throughput, retention, and per-plan quotas.