Making Matrix Feel Like WhatsApp Without Centralizing It
Gua is an experimental Matrix-based messenger built around a deliberately provocative question: can a federated, end-to-end encrypted network feel as simple as WhatsApp, and what do you have to centralize to get there?
The project is an experiment built around the Matrix ecosystem. It builds on Element clients for iOS, Android, and Web, Synapse, and Matrix Authentication Service, with targeted Gua-specific forks where the user experience requires it. Around those components, it adds Java/Spring services such as identity-service and gua-resolver, plus gua-idp-web, a web frontend for the identity provider login flow. The goal is to keep the robustness of Matrix federation while hiding the complexity that usually scares off everyday users: homeserver choice, full Matrix IDs, server-specific login details, and federation topology.
The public demo uses phone-number login with OTP, similar to WhatsApp-style onboarding. Returning users can be protected with a 6-digit account PIN or passkeys, and the OIDC/MAS architecture makes it possible to extend the same login model to government identity providers, institutional identity systems, or other trusted authentication sources.
The talk focuses on the architecture behind this abstraction: Gua Identity Service, Gua’s MAS fork, gua-idp-web, and gua-resolver. Together, these components let a client start from a simple user identity, route login or registration to the correct homeserver, and maintain a trusted federation of authorized homeservers without exposing those details to the user.
Gua is not presented as a finished product, but as a case study in making Matrix more approachable for mainstream and institutional adoption.
Matrix gives us federation, interoperability, end-to-end encryption, and the possibility of communication networks that are not controlled by a single vendor. But the average user does not want to think about homeservers, server names, Matrix IDs, login methods, federation topology, or trust boundaries. In many countries, messaging products such as WhatsApp became dominant partly because onboarding is extremely simple: enter a phone number, receive a code, and start talking.
Gua explores whether a Matrix-based messenger can offer that kind of simplicity without giving up the federated architecture underneath.
The project is a distribution and product experiment built around the Matrix ecosystem. It forks Element clients for iOS, Android, and Web, forks Synapse and Matrix Authentication Service where needed, and adds Gua-specific Java/Spring services such as identity-service and gua-resolver. It also includes gua-idp-web, a web frontend for the identity provider login flow.
The design makes several deliberate UX and architecture choices:
- users see usernames, not full Matrix IDs or homeserver names;
- clients do not ask users to choose a homeserver;
- the public demo uses phone-number OTP onboarding;
- returning users can use a 6-digit account PIN as two-step verification;
- passkeys and other identity providers can be added through the OIDC/MAS pattern;
- the resolver decides where a user should log in or register inside the Gua federation;
- trusted homeservers are admitted and verified through a resolver-controlled roster.
The talk will walk through how Gua Identity Service acts as an OIDC provider for MAS, how the Gua MAS fork reduces login friction for first-party clients, how gua-idp-web drives the phone -> OTP -> PIN/profile flow, and how gua-resolver ties the model together by resolving identities to homeservers and maintaining trust in the federation.
It will also discuss future potential directions: institutional deployments, login through SSO providers, and eventually bridging the user experience beyond the Gua-controlled federation toward the broader Matrix federation or other controlled Matrix federations such as Tchap.
Gua is an early-stage architecture and product-design case study about making Matrix federation usable for people who would otherwise never adopt a federated messenger.
Sarah is a software engineer based in Ottawa, Canada. In her day-to-day work, she builds backend services, cloud infrastructure, and distributed systems. She is the creator of Gua, an experimental Matrix-based federated messenger exploring simple identity-based onboarding, OIDC login, and trusted homeserver routing for sovereign communication networks. Her goal with Gua is to make Matrix-based communication approachable for everyday users while preserving the freedom, interoperability, and digital sovereignty that make open federated networks important.