Skip to content

docs: get buzz on your phone pairing guide #2361

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Chessing234 wants to merge 1 commit into
base: main
Choose a base branch
from
+39 −0
Open

docs: get buzz on your phone pairing guide #2361

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
<a href="VISION_PROJECTS.md">Forge</a> ·
<a href="VISION_AGENT.md">Agents</a> ·
<a href="ARCHITECTURE.md">Architecture</a> ·
<a href="docs/get-buzz-on-your-phone.md">Mobile</a> ·
<a href="LICENSE">Apache 2.0</a>
</p>

Expand Down
38 changes: 38 additions & 0 deletions docs/get-buzz-on-your-phone.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Get Buzz on your phone

Pair the Buzz mobile app with desktop so your identity and communities show up on your phone. Pairing copies *your* identity to a device you own. To onboard someone else, send them a community invite link instead.

## Install the mobile app

Search your store for **Buzz — chat with your hive**:

- **iOS:** App Store
- **Android:** Google Play (`xyz.block.buzz.mobile`)

Update the desktop app before pairing so both sides speak the same protocol.

## Pair with desktop

1. On desktop, open **Settings** (⌘, on Mac, or click your user icon in the bottom-left).
2. Open the **Mobile** tab and click **Pair Mobile Device**. A QR code appears: “Scan this QR code with the Buzz mobile app to securely pair.”
3. On your phone, open Buzz. On the welcome screen, tap **Scan QR Code** and point the camera at the desktop QR.
- No camera handy? Use **Copy pairing code** on desktop and paste it on the phone.
4. A short **security code** appears on both screens. Confirm they match, then confirm on **both** devices. Only confirm a pairing you started yourself.
5. When you see “Your mobile device is now paired,” your identity and communities are on the phone.

## Good to know

- **Codes don’t match?** Pairing cancels itself for security — start over from desktop.
- **Pairing vs invite:** pairing copies your existing identity to another of *your* devices. Use a community **invite link** when onboarding a teammate.
- **Push notifications** are supported on hosted communities.
- You can pair more than one phone; each device goes through the same flow.

## For workplace rollouts

Hand teammates this page (or a printout) with:

1. Store install links / QR codes for iOS and Android
2. The six pairing steps above
3. The community invite link for people who don’t already have a Buzz identity

Admins: after someone joins on desktop, point them to **Settings → Mobile → Pair Mobile Device**.