|
| 1 | +--- |
| 2 | +title: Atmosphere |
| 3 | +description: npmx.dev's role in the Atmosphere |
| 4 | +navigation: |
| 5 | + icon: i-lucide-cloudy |
| 6 | +--- |
| 7 | + |
| 8 | +<!-- INFO: Run locally with `pnpm dev:docs` --> |
| 9 | +<!-- TODO: Preliminary work to record all of the steps involved with the initial ATProto work. Please feel free to update and revise as you see fit. --> |
| 10 | + |
| 11 | +## Overview |
| 12 | + |
| 13 | +_npmx.dev_ site architecture as it pertains to the ATProtocol ecosystem, the [Atmosphere](https://atproto.com/). |
| 14 | + |
| 15 | +--- |
| 16 | + |
| 17 | +## Atmosphere |
| 18 | + |
| 19 | +The Atmosphere is the interconnected web of applications that all run on the ATProtocol. The primary benefit of this integration for nomx.dev are social features and connecting to the tens of millions of users ATProtocol on the social graph. Per the docs site: |
| 20 | + |
| 21 | +> The AT Protocol is an open, decentralized network for building social applications. |
| 22 | +
|
| 23 | +--- |
| 24 | + |
| 25 | +## Architecture |
| 26 | + |
| 27 | +These are the components that allow for _npmx.dev_ to exist as an app on the Atmosphere: |
| 28 | + |
| 29 | +1. **Domain** - _npmx.dev_ site |
| 30 | +2. **OAuth** - Required for interacting with the Atmosphere |
| 31 | +3. **Constellation** - A global atproto backlink index |
| 32 | +4. **Lexicons** - Schema definition language |
| 33 | +5. **Standard Site Sync** - Synchronizes app data with PDS |
| 34 | +6. **Bluesky Social Graph** - Consume Bluesky posts/comments/threads |
| 35 | + |
| 36 | +### Domain |
| 37 | + |
| 38 | +_npmx.dev_ site which serves as a third-party browser prioritized around high DX and native-like performance... |
| 39 | + |
| 40 | +### OAuth |
| 41 | + |
| 42 | +Necessary to ensure identities are observed... |
| 43 | + |
| 44 | +> OAuth is the primary mechanism in atproto for clients to make authorized requests to PDS instances. |
| 45 | +
|
| 46 | +https://atproto.com/specs/oauth |
| 47 | + |
| 48 | +### Constellation |
| 49 | + |
| 50 | +Orchestration API layer that collects...stuff... |
| 51 | + |
| 52 | +### Lexicons |
| 53 | + |
| 54 | +Orchestration API layer that collects...stuff... |
| 55 | + |
| 56 | +> Lexicon is a schema definition language used to describe atproto records, HTTP endpoints (XRPC), and event stream messages. |
| 57 | +
|
| 58 | +https://atproto.com/specs/lexicon |
| 59 | + |
| 60 | +### Standard Site Sync |
| 61 | + |
| 62 | +Synchronizes data changes from npmx.dev in the form of blog post MD files... |
| 63 | + |
| 64 | +### Personal Data Servers (PDS) |
| 65 | + |
| 66 | +The canonical source for a user identity, a PDS instance provides a substrate upon which to host user accounts and provide account management services. |
| 67 | + |
| 68 | +> Personal data servers, or PDSes, are your home in the cloud. They host your data, distribute it, manage your identity, and orchestrate requests to other services to give you your views. |
| 69 | +
|
| 70 | +If you’re wanting to migrate to _npmx.dev_’s PDS then the primary means is to leverage [PDS MOOver](https://pdsmoover.com/moover/npmx.social), made by the community's own @bailey-townsend. If you need further support migrating please join the community [Discord](https://chat.npmx.dev) and refer to the `#pds` channel. |
| 71 | + |
| 72 | +For more details refer to the official ATProto docs [here](https://atproto.com/guides/the-at-stack#pds). |
| 73 | + |
| 74 | +### Bluesky Social Graph |
| 75 | + |
| 76 | +Collects and generates events to utilize Posts/Comments/Threads |
| 77 | + |
| 78 | +--- |
| 79 | + |
| 80 | +## How & Why the Atmosphere |
| 81 | + |
| 82 | +These are the components that allow for _npmx.dev_ to exist as an app on the Atmosphere: |
| 83 | + |
| 84 | +1. **Blog Posts** - Share short and long form thought from the people behind the app |
| 85 | +2. **Comments** - Allows people to share their thoughts and feelings |
| 86 | +3. **Awareness** - Raises brand awareness |
| 87 | +4. **Engagement** - Promotes brand engagement |
| 88 | + |
| 89 | +--- |
| 90 | + |
| 91 | +## Resources |
| 92 | + |
| 93 | +These are the components that allow for _npmx.dev_ to exist as an app on the Atmosphere: |
| 94 | + |
| 95 | +- **ATProtocol Docs** - [Introduction](https://atproto.com) |
| 96 | +- **Constellation Repo** - [readme.md](https://github.com/at-microcosm/microcosm-rs/tree/main/constellation) |
| 97 | +- **Bluesky** - [Disocover Page](https://bsky.app/) |
| 98 | + |
| 99 | +--- |
0 commit comments