AT Protocol#App Views

{{primary sources|section|date=February 2025}}

The AT Protocol is designed to facilitate the creation of federated identities, so that users can retain, manage, and customize one online identity across multiple platforms and services. Bluesky Social describes the protocol as being "modeled after the open web".

Compared to other protocols for social networking such as ActivityPub, where implementations are typically designed as a monolithic server that hosts both user data and the application, it splits up these elements into smaller microservices, which can be used as needed.{{Cite web |url=https://atproto.com/articles/atproto-for-distsys-engineers |title=ATProto for distributed systems engineers |date=2024-09-03 |website=atproto.com }}{{failed verification|date=February 2025|reason=Source doesn't mention ActivityPub, suggesting that this comparison is original research}}

AT Protocol clients and services interoperate through an HTTP API called XRPC that primarily uses JSON for data serialization.{{Cite web |title=HTTP API (XRPC) {{!}} AT Protocol |url=https://atproto.com/specs/xrpc |access-date=2024-09-05 |website=atproto.com}} Additionally, all data within the protocol that must be authenticated, referenced, or stored is encoded in CBOR.{{Cite web |title=Data Model{{dash}}Protocol API Reference |url=https://atproto.com/specs/data-model#blob-type |access-date=2024-09-06 |website=atproto.com}}

The AT Protocol utilizes a dual identifier system: a mutable handle, in the form of a domain name, and an immutable decentralized identifier (DID). A handle serves as a verifiable user identifier. Verification is by either of two equivalent methods proving control of the domain name: Either a DNS query of a resource record with the same name as the handle, or a request for a text file from a Web service with the same name. DIDs resolve to DID documents, which contain references to key user metadata, such as the user's handle, public keys, and data repository.{{Cite web |title=Identity {{!}} AT Protocol |url=https://atproto.com/guides/identity |access-date=2024-09-05 |website=atproto.com}}File:AT Protocol Identity Architecture.svg

Services can assign handles to new users upon signup using subdomains (e.g. @username.bsky.social). Alternatively, users can set a custom domain or subdomain as their handle (e.g. @username.com or @username.wikipedia.org) by adding a TXT record to the domain's records or by responding to HTTP requests to a specific .well-known URL, associating the domain or subdomain with the user's DID.{{Cite web |title=Domain Names as Handles in Bluesky |url=https://bsky.social/about/blog/3-6-2023-domain-names-as-handles-in-bluesky |access-date=2024-09-05 |website=Bluesky |language=en}}{{Cite web |title=How to verify your Bluesky account |url=https://bsky.social/about/blog/4-28-2023-domain-handle-tutorial |access-date=2024-11-26 |website=Bluesky |language=en}}

The protocol's dual identifier system provides both user-friendly identifiers for use in end-user services and consistent cryptographic identities within the protocol, while also providing a robust TCP/IP-based account verification mechanism at the protocol level.

User data within the protocol is stored in dedicated data repositories, or "repos". Each user is associated with a single repository, over which they have exclusive management rights. Repositories contain mutable collections of user records, which log actions such as posts, likes, follows, and blocks. Records are persistent and can only be added or removed at the explicit request of the user.{{Cite web |title=Personal Data Repositories {{!}} AT Protocol |url=https://atproto.com/guides/data-repos |access-date=2024-09-05 |website=atproto.com}}

Each record within a repository's collection is assigned a unique record key, which is used by network agents to reference records within a user's repository. The current implementation of record keys is the timestamp identifier (TID), derived from the record's creation time.{{Cite web |title=Record Key{{dash}}Protocol API Reference |url=https://atproto.com/specs/record-key |access-date=2024-09-06 |website=atproto.com}} Repositories store collections in a Merkle search tree, which sorts records chronologically based on their TID.{{Cite web |title=Repository{{dash}}Protocol API Reference |url=https://atproto.com/specs/repository#repo-data-structure-v3 |access-date=2024-09-06 |website=atproto.com}}

Media files, along with their metadata, size, and media type, are stored separately from repositories as blobs, a type of unstructured binary data, in the user's host server.{{Cite web |title=Protocol API Reference |url=https://atproto.com/guides/glossary#blob |access-date=2024-09-06 |website=atproto.com}} This allows network agents to access and process arbitrary media files regardless of their original schema or upload context.{{Cite web |title=HTTP API (XRPC){{dash}}Protocol API Reference |url=https://atproto.com/specs/xrpc |access-date=2024-09-06 |website=atproto.com}}

Currently all data in repositories is public, but there are plans to add private data to the protocol.{{Cite web |title=AT Protocol |url=https://atproto.com/specs/atp#future-work |access-date=2025-04-21 |website=AT Protocol |language=en}}

Personal Data Servers (PDSes) host user repositories and their associated media. They also serve as the network access point for users, facilitating repository updates, backups, data queries, and user requests.{{Cite web |title=Federation Architecture {{!}} Bluesky |url=https://docs.bsky.app/docs/advanced-guides/federation-architecture |access-date=2024-09-05 |website=docs.bsky.app |language=en}}

Platform clients access the protocol on the user's behalf by querying their PDS, which, in turn, fetches the requested data from other services within the network. This design differs from ActivityPub, where protocol interactions and services are handled by monolithic host servers. Since network events are resolved through the protocol's network-wide indexing infrastructure, the availability of any single PDS is, by design, potentially inconsequential to the user experience.{{Cite web |title=PDS Entryway {{!}} Bluesky |url=https://docs.bsky.app/docs/advanced-guides/entryway |access-date=2024-09-05 |website=docs.bsky.app |language=en}}

The AT Protocol prioritizes data portability, enabling users to back up and migrate repositories and associated media without data loss, even in the event of an adversarial PDS.{{Cite web |title=Repository {{!}} AT Protocol |url=https://atproto.com/specs/repository |access-date=2024-09-05 |website=atproto.com}} The design of PDSes within the protocol results in low computational requirements for operation, allowing individuals or groups to run their own PDSes without the need for significant computational resources.

Although most users' repositories reside in PDSes run by Bluesky Social, many independent PDSes exist within the network.{{Cite web |date=2024-05-06 |title=2024 Protocol Roadmap {{!}} Bluesky |url=https://docs.bsky.app/blog/2024-protocol-roadmap |access-date=2024-09-05 |website=docs.bsky.app |language=en}}

Relays are a key component of the protocol's indexing infrastructure, serving as the core indexers within the network. Relays crawl the network by continuously fetching repository updates from PDSes before aggregating, indexing, and forwarding these updates into network-wide data streams, collectively called the firehose.{{Cite web |title=Firehose {{!}} Bluesky |url=https://docs.bsky.app/docs/advanced-guides/firehose |access-date=2024-09-05 |website=docs.bsky.app |language=en}} The firehose is available to all network agents, and can be consumed by any service within the network. Relays can choose to index all or part of the network.

By eliminating the need to crawl or store user data and providing a unified data stream, relays simplify the development of applications and services in the protocol and reduce their operational costs.{{Cite web |title=The AT Protocol Developer Ecosystem |url=https://bsky.social/about/blog/4-21-2023-atproto-developer-ecosystem |access-date=2024-09-05 |website=Bluesky |language=en}}

Relays have been criticized as being the most centralized component in the protocol's design, given their near-indispensable role in the network and a lack of clear incentives for running a relay.{{Cite web |title=AT Protocol{{dash}}First Thoughts{{dash}}Rusted Gears{{dash}}Obsidian Publish |url=https://publish.obsidian.md/rusted-gears/Rusted+Gears/AT+Protocol+-+First+Thoughts |access-date=2024-09-05 |website=publish.obsidian.md |language=en}}{{Cite web |last=Schulman |first=Rory Mir and Ross |date=2024-06-18 |title=What's the Difference Between Mastodon, Bluesky, and Threads? |url=https://www.eff.org/deeplinks/2024/06/whats-difference-between-mastodon-bluesky-and-threads |access-date=2024-09-05 |website=Electronic Frontier Foundation |language=en}}

App Views, analogous to current-day social networking services, are end-user platforms and services within the protocol that consume, process, and deliver data from the relay to user clients in response to queries from users' PDSes. They utilize network-wide information from the firehose, such as posts, likes, follows, and replies, to create customized user experiences within their clients.

The design of App Views within the protocol allows for significant variation in implementation. App Views can implement invite systems, custom algorithms, alternative clients, varying monetization and content moderation strategies, and off-protocol services.{{Cite web |title=Moderation in a Public Commons |url=https://bsky.social/about/blog/6-23-2023-moderation-proposals |access-date=2024-09-05 |website=Bluesky |language=en}} Despite these differences, all App Views operate from the same data sourced from the firehose. This architecture reduces the computational load and storage requirements of App Views, and prevents user lock-in by enabling users to easily switch between App Views while retaining their posts, follows, likes, etc.{{Cite web |title=What is Bluesky? |url=https://bsky.social/about/blog/6-13-2023-what-is-bluesky |access-date=2024-09-05 |website=Bluesky |language=en}}

The largest App View on the protocol is currently Bluesky, although other App Views, such as WhiteWind (a long-form blogging platform), Frontpage (a Hacker News-style social news website) and Smoke Signal (an RSVP management service) are also available within the protocol.{{Cite web |title=WhiteWind atproto blog {{!}} WhiteWind blog |url=https://whtwnd.com/about |access-date=2024-09-05 |website=whtwnd.com}}{{Cite web |title=Why atprotocol? {{!}} Smoke Signal |url=https://docs.smokesignal.events/blog/why-atprotocol/ |access-date=2024-09-05 |website=docs.smokesignal.events}}{{Cite web |last=Hof |first=Laurens |date=2024-07-04 |title=Last Month in Bluesky – June 2024 |url=https://fediversereport.com/last-month-in-bluesky-june-2024/ |access-date=2024-09-06 |website=fediversereport.com |language=en-US}}

All posts within the AT Protocol follow a specific global schema language called a lexicon to support different service and platform modalities.{{Cite web |title=Protocol Overview {{!}} AT Protocol |url=https://atproto.com/guides/overview |access-date=2024-09-05 |website=atproto.com}} App Views within the protocol have the flexibility to define their own unique lexicons, or utilize existing ones.

This approach allows App Views to create custom lexicons that are tailored to their specific use case while maintaining compatibility with the broader network. As an example, records displayed in an App View focused on microblogging would likely use a different lexicon than one focused on video-sharing, as their content types require different sets of attributes.

However, App Views can also choose to serve content using lexicons defined by other App Views, even if the content was originally posted elsewhere in the network.{{Cite web |title=Lexicon {{!}} AT Protocol |url=https://atproto.com/guides/lexicon |access-date=2024-09-05 |website=atproto.com}} For example, a new microblogging App View could choose to serve previously posted content using the lexicon defined by an established competitor, enabling them to provide novel features and services while maintaining compatibility with existing content.

This schema design is intended to eliminate user lock-in and foster user-centric innovation by forcing App Views to differentiate themselves through unique user experiences and additional functionality, rather than relying on exclusive access to content.{{Cite web |title=Bluesky: An Open Social Web |url=https://bsky.social/about/blog/02-22-2024-open-social-web |access-date=2024-09-05 |website=Bluesky |language=en}}

Lexicons are referenced within records using Namespaced Identifiers (NSIDs), which consist of a domain authority in reverse domain-name order, followed by an arbitrary name segment.{{Cite web |title=Namespaced Identifiers (NSIDs){{dash}}Protocol API Reference |url=https://atproto.com/specs/nsid |access-date=2024-09-06 |website=atproto.com}} For example, com.appview.foo is a valid NSID, where com.appview is the domain authority, and foo is the name segment.

The most popular lexicon in the protocol, app.bsky, defines Bluesky's microblogging schema.

Opinionated services are services within the protocol that process data from the firehose to provide subjective judgements on network data for the purposes of content moderation and curation. These services contrast with the intended "unopinionated" nature of relays and App Views. Opinionated services enable users to customize their content consumption and moderation preferences within the protocol while maintaining the neutrality of the protocol's core components.

Users have the ability to subscribe and unsubscribe to these services at any time through their client app (unless they are hard-coded into the user's current App View.) The modularity of these services allows for a customizable, stackable, user-centric approach to content curation and moderation within the protocol.{{Cite web |title=Bluesky's Stackable Approach to Moderation |url=https://bsky.social/about/blog/03-12-2024-stackable-moderation |access-date=2024-09-05 |website=Bluesky |language=en}}

Labelers produce judgements about user-generated content, such as identifying spam or inappropriate material. These labels can be applied to various aspects of the network, including posts, images, or accounts. The output of labelers is consumed by App Views and PDSes, which can then provide various strategies to users for handling labeled content, such as hiding, labeling, or blurring.{{Cite web |title=Labeling and Moderation Controls |url=https://github.com/bluesky-social/proposals/tree/main/0002-labeling-and-moderation-controls |access-date=2024-09-05 |website=GitHub |language=en}}

Bluesky Social has open-sourced its internal labeler moderation service "Ozone", allowing users to create custom moderation services for the network.{{Citation |title=Ozone: labeling service for Bluesky and other atproto apps |date=2024-09-05 |url=https://github.com/bluesky-social/ozone |access-date=2024-09-06 |publisher=bluesky-social}}

Although labelers can be used as moderation services, they can also serve informational or entertainment purposes, such as labeling post topics, user pronouns, or adding positive or playful labels to user profiles and posts.{{Cite web |title=Labeling and Moderation Controls |url=https://github.com/bluesky-social/proposals/tree/main/0002-labeling-and-moderation-controls |access-date=2024-09-06 |website=GitHub |language=en}}

Feed generators process posts within the firehose for inclusion in custom feeds. After a PDS query, they return a list of post IDs to the user's App View, which can then be used to create curated feeds.{{Cite web |title=Custom Feeds {{!}} Bluesky |url=https://docs.bsky.app/docs/starter-templates/custom-feeds |access-date=2024-09-05 |website=docs.bsky.app |language=en}}{{Citation |title=ATProto Feed Generator |date=2024-09-05 |url=https://github.com/bluesky-social/feed-generator |access-date=2024-09-06 |publisher=bluesky-social}}

The protocol's reference implementation was first released to GitHub on May 4, 2022 under the name Authenticated Data Experiment (ADX), and is licensed under both the MIT and Apache licenses.{{Cite web |last=Robertson |first=Adi |date=2022-05-04 |title=Twitter's decentralized, open-source offshoot just released its first code |url=https://www.theverge.com/2022/5/4/23057473/twitter-bluesky-adx-release-open-source-decentralized-social-network |access-date=2024-07-31 |website=The Verge |language=en}} It rebranded to the AT Protocol in October 2022.{{Cite web |last=Pierce |first=David |date=2022-10-19 |title=Bluesky built a decentralized protocol for Twitter — and is working on an app that uses it |url=https://www.theverge.com/2022/10/19/23412482/bluesky-at-protocol-decentralized-twitter-social-networks-app |access-date=2024-08-04 |website=The Verge |language=en}}

The AT Protocol has been adopted for use by the Bluesky social network (also developed by Bluesky Social PBC), and is its most popular implementation. The social network itself opened federation with other Personal Data Servers in late February 2024, as it had launched without the ability to federate with other servers not run by Bluesky Social.{{Cite web |last=Khalid |first=Amrita |date=2024-02-22 |title=Bluesky starts letting users host their own servers |url=https://www.theverge.com/2024/2/22/24080334/bluesky-self-hosting-servers-data-federated |access-date=2024-08-04 |website=The Verge |language=en}} Additionally, the news aggregator Flipboard allows users to log in with their Bluesky account to view and interact with posts from the service.{{Cite web |last=Davis |first=Wes |date=2023-05-23 |title=Flipboard is ready to work with Bluesky and Pixelfed |url=https://www.theverge.com/2023/5/23/23734581/flipboard-bluesky-pixelfed-federated-networks-activitypub-at-protocol |access-date=2024-08-01 |website=The Verge |language=en}} To aid adoption, Bluesky Social funds, via grants, various projects that use the AT Protocol for federating or creating content, or both.{{Cite web |last=Perez |first=Sarah |date=2024-03-11 |title=Bluesky is funding developer projects to give its Twitter/X alternative a boost |url=https://techcrunch.com/2024/03/11/bluesky-is-funding-developer-projects-to-give-its-twitter-x-alternative-a-boost/ |access-date=2024-08-01 |website=TechCrunch |language=en-US}} A notable application funded by the grants is a proxy server known as SkyBridge, which can convert API calls from Mastodon apps to their equivalent AT Protocol and Bluesky APIs, allowing users to have access to both networks even without official support.{{Cite web |last=Perez |first=Sarah |date=2024-04-25 |title=Bluesky backs a project that would let Mastodon apps, like Ivory, work with its network |url=https://techcrunch.com/2024/04/25/bluesky-backs-a-project-that-would-let-mastodon-apps-like-ivory-work-with-its-network/ |access-date=2024-08-09 |website=TechCrunch |language=en-US}}

While the AT Protocol is a separate protocol with no major technical similarities to other protocols, there have been services developed that can bridge content across protocols. An example is the Bridgy Fed software, which can crosspost content between all posts made on the ActivityPub protocol and posts using Bluesky lexicon on the AT Protocol.{{Cite web |last=Perez |first=Sarah |date=2024-06-05 |title=Bluesky and Mastodon users can now talk to each other with Bridgy Fed |url=https://techcrunch.com/2024/06/05/bluesky-and-mastodon-users-can-now-talk-to-each-other-with-bridgy-fed/ |access-date=2024-08-04 |website=TechCrunch |language=en-US}}{{Cite web |last=Silberling |first=Amanda |date=2024-02-14 |title=Bluesky and Mastodon users are having a fight that could shape the next generation of social media |url=https://techcrunch.com/2024/02/14/bluesky-and-mastodon-users-are-having-a-fight-that-could-shape-the-next-generation-of-social-media/ |access-date=2024-08-04 |website=TechCrunch |language=en-US}} Posts from Nostr can also be "double-bridged" to the AT Protocol via another bridge that can crosspost notes from Nostr to ActivityPub.{{Cite web |last=Perez |first=Sarah |date=2024-05-21 |title=The 'vote Trump' spam that hit Bluesky in May came from decentralized rival Nostr |url=https://techcrunch.com/2024/05/21/the-vote-trump-spam-that-hit-bluesky-in-may-came-from-decentralized-rival-nostr/ |access-date=2024-08-04 |website=TechCrunch |language=en-US}}

As Bluesky's popularity has grown, the protocol has also received more attention from both independent developers and investors. Most developers have opted to target solely Bluesky's API subset, as it allows for access of its pre-existing content and is easier to develop for. Notable among these are Flashes, a client with UI similar to Instagram,{{Cite web |last=Perez |first=Sarah |date=2025-01-15 |title=Exclusive: Bluesky is getting its own photo-sharing app, Flashes |url=https://techcrunch.com/2025/01/15/bluesky-is-getting-its-own-photo-sharing-app-flashes/ |access-date=2025-05-05 |website=TechCrunch |language=en-US}} and Skylight, a client with UI similar to TikTok backed by investor Mark Cuban,{{Cite web |last=Perez |first=Sarah |date=2025-04-01 |title=Mark Cuban backs Skylight, a TikTok alternative built on Bluesky's underlying technology |url=https://techcrunch.com/2025/04/01/mark-cuban-backs-skylight-a-tiktok-alternative-built-on-blueskys-underlying-technology/ |access-date=2025-05-05 |website=TechCrunch |language=en-US}} after he called for someone to develop a TikTok alternative on the protocol following the (at the time) impending ban of the app in the United States.{{Cite web |last=Perez |first=Sarah |date=2025-01-16 |title=Mark Cuban is ready to fund a TikTok alternative built on Bluesky's AT Protocol |url=https://techcrunch.com/2025/01/16/mark-cuban-is-ready-to-fund-a-tiktok-alternative-built-on-blueskys-at-protocol/ |access-date=2025-02-16 |website=TechCrunch |language=en-US}}

However, there have been apps developed independently from Bluesky's AppView and Lexicon, allowing for greater flexibility in what content is allowed.{{Cite web |last=Perez |first=Sarah |date=2025-01-28 |title=Reelo (now Spark) stands out among the apps building a 'TikTok for Bluesky' |url=https://techcrunch.com/2025/01/28/reelo-stands-out-among-the-apps-building-a-tiktok-for-bluesky/ |access-date=2025-05-05 |website=TechCrunch |language=en-US}} Examples of this include WhiteWind, a longform blogging application,{{Cite web |date=2024-11-28 |title=Protocol developer explains how decentralized Bluesky really is |url=https://gigazine.net/gsc_news/en/20241128-bluesky-decentralization/ |access-date=2025-05-06 |website=GIGAZINE |language=en}} Tangled, a Git collaboration application, and Roomy, a group chat application.{{Cite web |last=Perez |first=Sarah |date=2025-04-04 |title=Beyond Bluesky: These are the apps building social experiences on the AT Protocol |url=https://techcrunch.com/2025/04/04/beyond-bluesky-these-are-the-apps-building-social-experiences-on-the-at-protocol/ |access-date=2025-05-06 |website=TechCrunch |language=en-US}}

• ActivityPub, an alternative protocol that powers services like Mastodon
• Comparison of software and protocols for distributed social networking
• Nostr, a similar social networking protocol
• Secure Scuttlebutt

{{NoteFoot}}

{{reflist}}

• Bluesky and the AT Protocol: Usable Decentralized Social Media (2024)
• [https://steveklabnik.com/writing/how-does-bluesky-work/ How does BlueSky Work?] (2024)
• “I’m in the Bluesky Tonight”: Insights from a Year Worth of Social Data (2024)

• {{Official website|https://atproto.com/|name=Official website and documentation}}

{{Online social networking}}

{{Fediverse}}

{{Microblogging}}

Category:2022 introductions

Category:Communications protocols

Category:Distributed computing

Category:Social software