RIVR Documentation

RIVR is a federated social/civic coordination platform. Sovereign instances (person, group, locale, region) run independently and federate into the hosted global app for discovery, marketplace, credentialing, and cross-instance interaction. This site documents what RIVR does and how to build against it.

It has two tabs:

📖 Wiki

Every user-facing surface, documented at click level: what each screen is, where it lives in the app, every interaction (buttons, menus, forms) and its result, who can see or do it, and how it connects to the rest of the platform.

Start with the Wiki index for the full surface list.

🔌 API

Developer reference for building against RIVR — machine-generated from source and regenerated on every build, so it never drifts from the code:

REST reference — every /api/** route handler, grouped by top-level segment, with HTTP methods, public/gated access, and a description.
MCP tools — the full Model Context Protocol tool surface (118 tools across 15 registries) with parameter tables and auth badges.
Federation protocol — the Ed25519-signed event + peer-registry endpoints that sovereign instances federate through.
Auth models — the three principals RIVR authenticates: session, MCP token, and peer signature.

This site stays in parity with the code

The API reference is emitted by tools/docs-gen-api.ts and tools/docs-gen-mcp.ts from the live route tree and MCP tool definitions, run by the prebuild hook before every next build. The wiki is maintained under the standing docs-parity rule: any change to a user-facing surface updates its wiki page in the same commit.