gitwtfhub

wtf is social-app?

gaearon/social-app — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2026-01-09

★ 12Audience · developerComplexity · 4/5QuietSetup · hard

TL;DR

The official codebase for Bluesky, a decentralized Twitter-like social app built on AT Protocol, running on web, iPhone, and Android from one shared code.

Mindmap

mindmap
  root((social-app))
    What it does
      Decentralized social feed
      Post and follow
      Cross-platform app
    Tech stack
      React Native
      TypeScript
      Go
      AT Protocol
    Use cases
      Contribute to Bluesky
      Fix bugs or UI
      Fork for your own app
    Audience
      App developers
      Bluesky team
    Contributing
      Check existing issues
      Discuss big changes
      Prefer focused fixes

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Contribute bug fixes or UI improvements to the official Bluesky app.

REASON 2

Study how a decentralized, AT Protocol-based social app is built across web and mobile.

REASON 3

Fork the app to build your own rebranded social platform on AT Protocol.

What's in the stack?

React NativeTypeScriptGoAT Protocol

How it stacks up

gaearon/social-app0xhossam/uncanny89171/web3-101
Stars121212
Language—C—
Last pushed2026-01-09——
MaintenanceQuiet——
Setup difficultyhardhardeasy
Complexity4/55/51/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires connecting to AT Protocol backend services and cross-platform mobile tooling.

Yoink these prompts

Prompt 1
Help me set up the Bluesky social-app repo locally so I can run it and start contributing.
Prompt 2
Explain how this codebase talks to Bluesky's backend through AT Protocol packages.
Prompt 3
I want to fork social-app into my own branded client, what do I need to change?

Frequently asked questions

wtf is social-app?

The official codebase for Bluesky, a decentralized Twitter-like social app built on AT Protocol, running on web, iPhone, and Android from one shared code.

Is social-app actively maintained?

Quiet — no commits in 6-12 months (last push 2026-01-09).

How hard is social-app to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is social-app for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane