gitmyhub

statusphere-react

★ 3 updated 9mo ago ⑂ fork

a fork of the atproto "statusphere" demo that uses vite/react

A minimal Twitter-like status-sharing app built on the decentralized AT Protocol, with a React frontend and Node.js backend.

ReactViteNode.jsExpressTypeScriptAT ProtocolOAuthsetup: moderatecomplexity 3/5

Statusphere React: What It Does

Statusphere is a simple social status-sharing app built with modern web tools. Think of it like a minimal Twitter or Bluesky clone where users can sign in, share short status updates, and see what others are posting in real time. The twist is that it's built on top of the AT Protocol, which is a decentralized network protocol that lets apps talk to each other through a shared social graph.

The app has two main parts working together: a React frontend (the visual interface you interact with in your browser) and a Node.js backend (the server that handles the heavy lifting). When you use the app, you sign in using OAuth (the same "sign in with Google" style login you see everywhere), then you can publish status updates to your account and watch a live stream of new statuses from everyone on the network. The backend listens to the network's "firehose" — essentially a constant feed of all new data — and serves it up to your browser.

Who would use this? Developers exploring decentralized social networks would find it useful as a working example. If you're learning how to build apps that talk to the AT Protocol, this repo shows you the real code for signin flows, user profiles, publishing data, and handling live network updates. Founders thinking about social or community features might study it to understand how decentralized protocols differ from traditional centralized backends.

The project uses Vite and React on the frontend (modern, fast build tools) and Express on the backend, which keeps things straightforward. Everything is written in TypeScript so you get type safety. The README doesn't go into heavy detail about the AT Protocol itself, assuming you'll learn that separately, but the code is there to learn from. Deployment is simple too — it bundles the frontend and backend into one process, so you can run it anywhere that supports Node.js.

Where it fits