bluesky-social /social-app

The Bluesky Social application for Web, iOS, and Android

★ 18,390⑂ 2,889👁 104⑃ 8,386● 3,945▤ 80
TypeScriptMITCreated 2022-06-07bsky.app
More from this author
Download: v1.137.0v1.137.0 ↓1.137.02026-10-29
+1
Daily
18,390
stars
2,889
forks
104
watchers
8,386
prs
3,945
issues
80
releases

README

Bluesky Social App

Welcome friends! This is the codebase for the Bluesky Social app.

Get the app itself:

- Web: bsky.app
- iOS: App Store
- Android: Play Store

 Development Resources

This is a React Native application, written in the TypeScript programming language. It builds on the atproto TypeScript packages (like @atproto/api), which are also open source, but in a different git repository.

There is a small amount of Go language source code (in ./bskyweb/), for a web service that returns the React Native Web application.

The Build Instructions are a good place to get started with the app itself.

The Authenticated Transfer Protocol ("AT Protocol" or "atproto") is a decentralized social media protocol. You don't need to understand AT Protocol to work with this application, but it can help. Learn more at:

- Overview and Guides
- GitHub Discussions 👈 Great place to ask questions
- Protocol Specifications
- Blogpost on self-authenticating data structures

The Bluesky Social application encompasses a set of schemas and APIs built in the overall AT Protocol framework. The namespace for these "Lexicons" is app.bsky..

 Contributions

 [!NOTE]
 While we do accept contributions, we prioritize high quality issues and pull requests. Adhering to the below guidelines will ensure a more timely review.

Rules:

- We may not respond to your issue or PR.
- We may close an issue or PR without much feedback.
- We may lock discussions or contributions if our attention is getting DDOSed.
- We're not going to provide support for build issues.

Guidelines:

- Check for existing issues before filing a new one please.
- Open an issue and give some time for discussion before submitting a PR.
- Stay away from PRs like...
  - Changing "Post" to "Skeet."
  - Refactoring the codebase, e.g., to replace React Query with Redux Toolkit or something.
  - Adding entirely new features without prior discussion. 

Remember, we serve a wide community of users. Our day-to-day involves us constantly asking "which top priority is our top priority." If you submit well-written PRs that solve problems concisely, that's an awesome contribution. Otherwise, as much as we'd love to accept your ideas and contributions, we really don't have the bandwidth. That's what forking is for!

 Forking guidelines

You have our blessing 🪄✨ to fork this application! However, it's very important to be clear to users when you're giving them a fork.

Please be sure to:

- Change all branding in the repository and UI to clearly differentiate from Bluesky.
- Change any support links (feedback, email, terms of service, etc) to your own systems.
- Replace any analytics or error-collection systems with your own so we don't get super confused.
- Replace the landing-screen illustration in assets/illustrations/. It is commissioned artwork licensed to Bluesky alone, and our MIT license does not cover it.
- Source your own UI icons. The glyph set in assets/icons/ is licensed to us by a third party for our own us

Top issues

Latest release

v1.137.0 1.137.0 2026-10-29
What's Changed
 Split the react-native patch into one file per change by @tomekzaw in https://github.com/bluesky-social/social-app/pull/12143
 Block more shortener and redirect domains in profile links by @vineyardbovines in https://github.com/bluesky-social/social-app/pull/12144
 Suggest a standard.site blog's own title for profile links by @vineyardbovines in https://github.com/bluesky-social/social-app/pull/12145
 Fix missing paper plane icon in chat send button by @ds-boyce in https://github.com/bluesky-social/social-app/pull/12149
 Fix iOS e2e flows (create-account, login, thread-mut

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON