The Bluesky Social application is a cross-platform client for the decentralized social network built on the AT Protocol. Available as a web application at bsky.app, an iOS app through the App Store, and an Android app via the Play Store, this repository contains the complete codebase for the Bluesky Social user-facing application. The project is written primarily in TypeScript and built as a React Native application, allowing it to run across web, iOS, and Android platforms from a shared codebase. A small amount of Go code in the bskyweb directory handles the web service that serves the React Native Web application.
The application builds on the atproto TypeScript packages, particularly the @atproto/api package, which are maintained in a separate repository. The AT Protocol, or Authenticated Transfer Protocol, is a decentralized social media protocol that enables federated social networking without centralized control. While understanding the protocol is not required to work with the application, the Bluesky Social app implements schemas and APIs within the AT Protocol framework under the app.bsky namespace, known as Lexicons.
The repository is classified across multiple domains including Social Network, Decentralized, Microblogging, Client App, Feeds, Profiles, Posting, Community, AT Protocol, and Content Sharing.
The project explicitly welcomes contributions but maintains clear guidelines prioritizing high-quality issues and pull requests. The maintainers note they may not respond to all submissions and reserve the right to close issues or PRs without extensive feedback. Contributors are encouraged to check for existing issues before filing new ones and to open discussions before submitting pull requests. The team discourages refactoring efforts, terminology changes, and entirely new features without prior discussion, citing bandwidth constraints and the need to prioritize user-facing improvements.
The repository encourages forking with specific requirements that forks must change all branding to differentiate from Bluesky, update support links to independent systems, and replace analytics and error-collection systems to avoid confusion with the official application. Security issues should be reported to [email protected]. The project is licensed under the MIT license and Bluesky Social PBC has committed to a software patent non-aggression pledge, ensuring the technology remains open for third-party development including custom feeds, federated services, and alternative clients.
