Team hub + first-time mental model (end silent team creation; teammates directory)

[kipavy]

Part of the team-ux initiative (siblings: #65–#69). Arguably the biggest "magic" gap — there is no home base or mental model for teams.

Relates: #66 (a directory feeds one-tap invites), #68 (silent team creation), #70 (first-access orientation).

Problem

There is no single "Team" home. Team state is scattered — Members lives per-vault (MembersPage.tsx), pending invites are a dashed sidebar icon, sessions are a separate rail, presence is elsewhere again. Worse, a team is auto-created silently the first time you invite someone from a private vault (handlePrivateAdd → createTeam(vault.name), see #68), so users never form a mental model of what a team is, how it differs from a personal vault vs a team vault, or where to manage any of it. A first-timer is dropped into a system of concepts with no orientation.

Proposed reflow

• A "Team" hub — one place that answers "who's on my team, what's shared, what's live, what needs my attention":
  • Teammates directory (with presence) — the source for Direct "invite this teammate" to a live session — one-tap join, no code #66's one-tap "invite this teammate," and a shortcut to share a vault (Explicit "Share" verb for vaults — a real share sheet, and unify the two invite panels #68) or start a session with someone.
  • Shared-with-me vs shared-by-me vaults & sessions at a glance.
  • Entry to member/role administration (B+C batch) and pending items (Unified team notification inbox — invites, shared sessions & control requests through the bell + toasts #67).
• First-time orientation: a short, honest explanation of team vs personal vault vs team vault, surfaced the moment a team first comes into being (no more silent creation).
• Naming the mental model consistently across the app so "team," "team vault," and "shared" mean one thing each.

Decisions (brainstorm 2026-07-24)

• Silent team creation must end — coming into a "team" is a real state change and deserves a moment (coordinated with Explicit "Share" verb for vaults — a real share sheet, and unify the two invite panels #68's conversion consent).
• The teammates directory is the discovery primitive the "zero-friction" invites (Direct "invite this teammate" to a live session — one-tap join, no code #66) lean on; it belongs here rather than buried in a share menu.

Still open

• Where the hub lives (top-level nav? a view? part of settings?).
• How much is a true "hub" vs. lightweight orientation + better cross-links between existing surfaces (avoid building a heavy new screen if links suffice).
• Scope of the directory (team members only, or anyone you share vaults with).
• Mobile.