Skip to content

Commit 28b193c

Browse files
committed
feat: Added a dedicated PDS section
1 parent dd5ec03 commit 28b193c

File tree

2 files changed

+101
-0
lines changed

2 files changed

+101
-0
lines changed
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
title: Integrations
2+
icon: i-lucide-cable
Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
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

Comments
 (0)