Deploy and Host Statusphere on Railway, a minimal but complete atproto app

Statusphere is a minimal atproto app. You can build your own by following the tutorial. This template runs a fork of that tutorial, which splits it into a Vite/React SPA frontend, and a Node.js backend. The database is a SQLite file stored in persistent railway volume.

The code for statusphere-react can be found here: https://tangled.org/@samuel.bsky.team/statusphere-react

Common Use Cases

Show off your first atproto application
Create the next generation of social apps!

About Hosting Statusphere

Atproto app generally require using long-running websockets, and therefore are a poor fit for serverless hosting platforms. Since Railway lets you run a persistent service, it's the perfect way to get started.

Aggregating every Statusphere Status event in the atproto network costs approximately $1.50 per month, which fits comfortably in the Railway hobby plan. Your mileage may vary, especially if you want to start aggregating Bluesky-related records.

Dependencies for Statusphere

Frontend (client)
- Vite
- React
- React Router (SPA)
Backend (appview)
- Node.js
- Express/@atproto/xrpc-server
- Jetstream (lightweight atproto firehose)
- SQLite

Deployment Dependencies

You need to fill in 3 environment variables: COOKIE_SECRET, PUBLIC_URL, and HOST

`COOKIE_SECRET`

A 32 character random string. You can generate one by running openssl rand -base64 32 in your terminal.

`PUBLIC_URL`

The URL of your site, for example https://statusphere.example.com

`HOST`

The hostname of your public URL, for example statusphere.example.com

Why Deploy Statusphere on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Statusphere on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.