{"name":"social-app: Bluesky Social for Web, iOS, and Android","description":"Bluesky Social is a social app for Web, iOS, and Android, built with React Native and TypeScript on the AT Protocol. Its codebase includes the app and a small Go service that serves the web application.","github":"https://github.com/bluesky-social/social-app","url":"https://osrepos.com/repo/bluesky-social-social-app","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/bluesky-social-social-app","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/bluesky-social-social-app.md","json":"https://osrepos.com/repo/bluesky-social-social-app.json","topics":["typescript","react","web-app","cross-platform","social-network","social-media","at-protocol","decentralized-social"],"keywords":["typescript","react","web-app","cross-platform","social-network","social-media","at-protocol","decentralized-social"],"stars":null,"summary":"Bluesky Social is a social app for Web, iOS, and Android, built with React Native and TypeScript on the AT Protocol. Its codebase includes the app and a small Go service that serves the web application.","content":"## Overview\n\nBluesky Social is the application for the Bluesky social network, available on Web, iOS, and Android. It is built with React Native and TypeScript, uses AT Protocol TypeScript packages such as `@atproto/api`, and defines Bluesky-specific schemas and APIs in the `app.bsky.*` Lexicon namespace.\n\nThe repository contains the app code and a small Go service that returns the React Native Web application. It is intended for people building or adapting Bluesky's client, rather than as a general-purpose social networking framework; the AT Protocol implementation lives in a separate repository.\n\n## Key Features\n\n- Provides Bluesky's social app across Web, iOS, and Android.\n- Uses React Native to share application code across platforms.\n- Implements the client in TypeScript and builds on AT Protocol TypeScript packages.\n- Includes Bluesky-specific schemas and APIs under the `app.bsky.*` namespace.\n- Contains a Go service for serving the React Native Web application.\n- Documents build instructions, contribution guidance, and precautions for app forks.\n\n## Use Cases\n\n- Developers can study or contribute to the client that powers Bluesky's social app.\n- Teams can build a differentiated client fork for a community, provided they replace Bluesky branding and assets and supply their own support systems.\n- Contributors can make focused fixes to the existing React Native and TypeScript app after discussing changes with maintainers.\n- Developers building AT Protocol integrations can examine how Bluesky's own app uses its `app.bsky.*` schemas and APIs.\n\n## Our Take\n\nThis is an actively maintained, cross-platform reference client for Bluesky, with a substantial contribution workflow but important asset and branding boundaries for forks.\n\n**Good fit if:**\n- You need to work on the Bluesky app for Web, iOS, or Android using React Native and TypeScript.\n- You are building an AT Protocol client and want to inspect Bluesky's `app.bsky.*` implementation.\n- Your team can work with the documented Node.js and Ruby requirements and follow the repository's contribution process.\n\n**Look elsewhere if:**\n- You need the AT Protocol packages themselves, which are maintained in the separate `bluesky-social/atproto` repository.\n- You want a ready-made generic social app or plan to ship a fork without replacing Bluesky branding, support links, analytics, and restricted assets.\n- Your team cannot meet the stated Node.js and Ruby requirements.\n\n## Project Health\n\n| Signal | Value |\n|---|---|\n| Status | **Active**: regular commits and releases |\n| Last commit | 2026-10-24 (1 day ago) |\n| Commits, last 90 days | 100+ |\n| Releases, last 12 months | 34 (latest 1.136.0, 2026-10-21) |\n| Contributors | 100+ (top contributor: 24% of commits) |\n| Issues closed, last 90 days | 2+ |\n| Pull requests merged, last 90 days | 89 (typically merged in 0 days) |\n| Project age | 4 years |\n\nChecked on 2026-10-25 with the GitHub API.\n\n## Project Facts\n\n- Language: TypeScript\n- License: MIT\n- Stars: 18.4k\n- Forks: 2.9k\n- Website: https://bsky.app\n- Archived: no\n\n## What You Need\n\nDetected in the repository:\n\n- Node.js >=24.22.1 (from package.json)\n- Ruby (from Gemfile)\n- A Dockerfile, so it can run in a container\n- A test suite and automated checks on GitHub Actions\n\n## Getting Started\n\nSee the [build instructions](https://github.com/bluesky-social/social-app/blob/main/docs/build.md) for setup and platform-specific steps. For the protocol packages used by the app, see the [AT Protocol repository](https://github.com/bluesky-social/atproto).\n\n## License in Plain Words\n\n**MIT** (permissive).\n\n- Commercial use: yes\n- Modify and redistribute: yes\n- You must keep: the copyright and license notice\n- Share your changes: no\n\nA summary, not legal advice: the LICENSE file is what applies.\n\n## Alternatives\n\n- [pixelfed](https://osrepos.com/repo/pixelfed-pixelfed): Pixelfed focuses on photo sharing across the fediverse and supports self-hosting, while social-app is Bluesky’s AT Protocol social client for web and mobile.\n\n| Project | Language | License | Stars | Status |\n|---|---|---|---|---|\n| **social-app** | TypeScript | MIT | 18.4k | Active |\n| [pixelfed](https://osrepos.com/repo/pixelfed-pixelfed) | PHP | AGPL-3.0 | 7.1k | Active |\n\n## Considerations\n\n- The repository's MIT license covers source code, but not every asset. Some artwork, icons, fonts, and brand assets are third-party licensed or trademarks; review [`ASSETS.md`](https://github.com/bluesky-social/social-app/blob/main/ASSETS.md) and [`NOTICE.md`](https://github.com/bluesky-social/social-app/blob/main/NOTICE.md) before distributing a fork.\n- Fork maintainers are expected to change branding and support links, replace analytics and error collection, and source their own icons and artwork.\n- The project requires Node.js `>=24.22.1` and Ruby. Docker is available, but the README directs developers to the build guide rather than providing a one-command setup.\n- The maintainers prioritize focused, discussed contributions and state that they may not respond to every issue or pull request; the repository is not a source of build support.","metrics":{"detailViews":1,"githubClicks":0},"dates":{"published":null,"modified":"2026-10-25T08:00:22.000Z"}}