Users
What a KEWEKE user is and when you need one.
A user in KEWEKE is a browser-based identity — not an email account. Your browser creates a personal key for you on first visit and remembers your display name. No passwords.
What it is
- You pick a display name (1–48 characters). That name is what friends see next to items you add or edit.
- Behind the scenes that name is backed by a browser-generated key, so the service can verify that edits really come from you.
- Your avatar shape is derived from your identity plus your name — rename yourself and the shape updates.
The three states
The settings page at /user shows which state you are in:
Anonymous
Anonymous
No username yet. signed badges show unsigned.
Local user
Jorge
username="Jorge" stored locally only.
Remote user
Jorge
remoteUsername confirmed. Can publish & sign remotely.
- Anonymous — you have not chosen a name yet. You can still make lists; your items show as “unsigned.” Choose a name before publishing.
- Local — you have a name on this browser only. It appears on items you create here, and your first confirmed publish connects this browser so the list can be used on other devices.
- Remote — your name is linked to the service. You can edit shared lists, approve your other browsers, and publish without creating the connection during the publish flow.
User settings
Remote user
Jorge
| Setting | Details |
|---|---|
Username Your display name across lists | Set the name attached to your list edits and items. |
Remote account Use this user across browsers | Create a remote user so you can pair other browsers and publish lists. |
Pair a browser Use on another device | Generate a pairing code and approve it from an existing device. |
Approve a browser Add another device | Enter the ten-character pairing code shown on another device. |
Accepted devices Manage devices | Every active device that can sign mutations. |
Passkeys Sign in without pairing codes | Add passkeys to instantly adopt a new browser. |
Session Log out | Disconnect this identity from this browser. Lists are retained. |
Local data Clear this browser | Remove local lists, identity, and stored data. Remote lists not deleted. |
The table on that page adapts to your state — it shows only the rows that make sense for you.
Where your name appears
Your name and avatar show up in places you already use:
| item | qty | signed |
|---|---|---|
| Bread | 1 EA | unsigned |
| Milk | 2 EA |  alice |
| Coffee · edited | 1 BAG |  bob |
| Tomatoes | 6 EA |  Your username |
- next to each item you add or last edited, in the shopping list
- in the header of the
/usersettings page - in the small popup that explains who added an item
For a complete tour, see What you see. How identities and live sharing work under the hood is covered in Architecture — Identity.
The components used here — the settings table and the signed badge — come from the auth components and the list components.