Groups & subgroups

What it is

Groups are agent-owned communities/orgs with their own feed, members, tabs, and resources. Groups can nest (subgroups) with a lineage breadcrumb, and org-descendant subgroups get the full org tab set. Rings and families are related group-like containers.

Where it lives

/groups — directory · src/app/(main)/groups/page.tsx
/groups/[id] — group home + tabs · src/app/groups/[id]/page.tsx (group-tabs-client.tsx)
/groups/[id]/settings — group settings · src/app/groups/[id]/settings/page.tsx
/groups/[id]/docs — group docs/filesystem · src/app/groups/[id]/docs/page.tsx
/rings, /rings/[id], /families, /families/[id] — related containers

Every interaction

Join / leave — toggle membership on a group or ring.
Request to join / approve — request-gated groups; admins approve or deny.
Tier-gated subgroups — a subgroup may require an active RIVR subscription of a specific tier to join (the RIVR org carries one per tier: Collaborators, Hosts, Sellers, Providers, Organizations). Subscribing auto-enrolls you; a lapsed subscription retires the membership. The RIVR org also carries Workers (org admins + worker share holders), Stewards (financial share holders — steward-tier subscribers and Steward-Share holders), and Directors (the org creator). Under Stewards nest the three steward-share subclasses from the cooperative's governance documents — Founders (the pre-incorporation Founder Block), Class R (community/intrastate offerings), and Class D (accredited investors) — hidden share classes whose holdings automatically confer Stewards membership.
Browse tabs — feed, members, events, projects, docs, and org tabs for org-typed groups and their descendant subgroups.
Lineage breadcrumb — navigate up the subgroup → parent → org chain.
Post as the group — admins author group-owned posts (see Feeds & posts).
Manage settings — name, description, visibility, membership policy, member capability toggles (TODO(verify): enumerate the exact toggle set live).

Membership dues & treasury

A group can charge membership dues — its own paid membership plans, set in Settings → Memberships. Members are billed through Stripe; the charge is grossed up so the group nets the full plan price it set (see Wallet & treasury). Dues revenue and every other inflow land in the group treasury, managed from the group's Treasury tab (funds, subgroup allocations, payouts, and — where enabled — a crypto (USDC) treasury held in an officer-controlled Safe multisig).

Federated members — people whose home account is on another RIVR instance — can join, pay dues, and buy from the group with their verified identity; their membership and purchases bind to the same recognized principal everywhere.

Permissions / gating

Public group pages are readable by guests (/groups is a public prefix).
Members see member-only content and can post/participate per capability.
Group admins manage membership, settings, subgroups, and group authorship.
Creating a group: community, family, and ring groups are free for any signed-in user. Creating an organization-type group requires an Organization membership (create_org_group capability). Nesting a subgroup under an existing org needs only write access on that org, not a fresh tier. See Membership & capabilities.
Group-agent ownership: the group is itself an agent that can own resources.

Cross-links

API/MCP: Groups tools · Group lifecycle tools · rivr.groups.join · /api/groups REST · /api/billing/group-subscribe
Wiki: Projects & jobs · Governance · Docs, filesystem & vault · Badges & stake · Membership & capabilities
Federation: sovereign group instances federate to global; membership lifecycle emits signed events.

Where it lives

/groups — directory · src/app/(main)/groups/page.tsx

/groups/[id] — group home + tabs · src/app/groups/[id]/page.tsx (group-tabs-client.tsx)

/groups/[id]/settings — group settings · src/app/groups/[id]/settings/page.tsx

/groups/[id]/docs — group docs/filesystem · src/app/groups/[id]/docs/page.tsx

/rings, /rings/[id], /families, /families/[id] — related containers

Every interaction

Join / leave — toggle membership on a group or ring.

Request to join / approve — request-gated groups; admins approve or deny.

Tier-gated subgroups — a subgroup may require an active RIVR subscription of a specific tier to join (the RIVR org carries one per tier: Collaborators, Hosts, Sellers, Providers, Organizations). Subscribing auto-enrolls you; a lapsed subscription retires the membership. The RIVR org also carries Workers (org admins + worker share holders), Stewards (financial share holders — steward-tier subscribers and Steward-Share holders), and Directors (the org creator). Under Stewards nest the three steward-share subclasses from the cooperative's governance documents — Founders (the pre-incorporation Founder Block), Class R (community/intrastate offerings), and Class D (accredited investors) — hidden share classes whose holdings automatically confer Stewards membership.

Browse tabs — feed, members, events, projects, docs, and org tabs for org-typed groups and their descendant subgroups.

Lineage breadcrumb — navigate up the subgroup → parent → org chain.

Post as the group — admins author group-owned posts (see Feeds & posts).

Manage settings — name, description, visibility, membership policy, member capability toggles (TODO(verify): enumerate the exact toggle set live).

Membership dues & treasury

Permissions / gating

Public group pages are readable by guests (/groups is a public prefix).

Members see member-only content and can post/participate per capability.

Group admins manage membership, settings, subgroups, and group authorship.

Creating a group: community, family, and ring groups are free for any signed-in user. Creating an organization-type group requires an Organization membership (create_org_group capability). Nesting a subgroup under an existing org needs only write access on that org, not a fresh tier. See Membership & capabilities.

Group-agent ownership: the group is itself an agent that can own resources.