You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/content/4.integrations/1.atmosphere.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ _npmx.dev_ site architecture as it pertains to the ATProtocol (ATProto) ecosyste
13
13
14
14
## Atmosphere
15
15
16
-
The Atmosphere is the interconnected web of applications that all run on the ATProto. The primary benefits of this integration for _npmx.dev_ are the social features that connect us to the tens of millions of users on the ATProto social graph. Per the docs site:
16
+
The Atmosphere is the interconnected web of applications that all run on ATProto. The primary benefits of this integration for _npmx.dev_ are the social features that connect us to the tens of millions of users on the ATProto social graph. Per the docs site:
17
17
18
18
> The AT Protocol is an open, decentralized network for building social applications.
19
19
@@ -23,7 +23,7 @@ The Atmosphere is the interconnected web of applications that all run on the ATP
23
23
24
24
These are the essential components that allow for _npmx.dev_ to exist as an app on the Atmosphere:
25
25
26
-
1.**App View** - _npmx.dev_ site
26
+
1.**Domain** - _npmx.dev_ site
27
27
2.**OAuth** - Required for interacting with the Atmosphere
28
28
3.**Constellation** - A global atproto backlink index
29
29
4.**Lexicons** - Schema definition language
@@ -33,7 +33,7 @@ These are the essential components that allow for _npmx.dev_ to exist as an app
33
33
34
34
For more details refer to the official ATProto docs [here](https://atproto.com/guides/the-at-stack).
35
35
36
-
### App View
36
+
### Domain
37
37
38
38
The _npmx.dev_ app is the frontend domain for the site which acts as a third-party browser for the extant [npmjs site](https://www.npmjs.com) but prioritized around high developer experience (DX) and native-like performance. As it concerns the idiomatic Atmosphere stack, it serves as the client entry point and enables user controls for `@npmx.social` profiles.
39
39
@@ -51,12 +51,16 @@ For more details refer to the official ATProto docs [here](https://atproto.com/s
51
51
52
52
Constellation serves as the API orchestration layer and backend indexer. It acts as a bridge between _npmx.dev_ specific data structures and the wider ATProto network. Specifically, it indexes backlinks, aggregates app-view data, and manages the caching layer to reduce load on individual PDS instances during high-traffic events.
53
53
54
+
For more details refer to the official Constellation site [here](https://constellation.microcosm.blue/).
55
+
54
56
### Lexicons
55
57
56
58
This is the glue that makes _npmx.dev_ data understandable to other ATProto apps. We utilize custom Lexicons to define the schema for _npmx.dev_ specific record types, such as our social features, package reviews, or documentation comments.
57
59
58
60
> Lexicon is a schema definition language used to describe atproto records, HTTP endpoints (XRPC), and event stream messages.
59
61
62
+
For the _npmx.dev_ specific implementation you can see them in the repo [here](https://atproto.com/specs/lexicon) and as they become more fixed we will publish their accompanying schemas.
63
+
60
64
For more details refer to the official ATProto docs [here](https://atproto.com/specs/lexicon).
61
65
62
66
### Personal Data Servers (PDS)
@@ -71,7 +75,9 @@ For more details refer to the official ATProto docs [here](https://atproto.com/g
71
75
72
76
### Standard Site Sync
73
77
74
-
The mechanism for ensuring state consistency between _npmx.dev_ and our self-hosted PDS. Standard Site Sync acts as a specialized repository synchronization layer that translates changes from the _npmx.dev_ platform, such as when we publish a new blog post in the form of a Markdown file, into valid ATProto records that are then pushed to a user's PDS. This ensures that content created on _npmx.dev_ lives permanently in the user's data repository.
78
+
Standard Site Sync acts as a specialized repository synchronization layer that translates changes from the _npmx.dev_ platform, such as when we publish a new blog post in the form of a Markdown file, into valid ATProto records that are then pushed to a user's PDS. It is the mechanism for maintaining state consistency between _npmx.dev_ and our self-hosted PDS, which ensures that content created on _npmx.dev_ lives permanently in the user's data repository.
79
+
80
+
For more details refer to the official Standard Site [here](https://standard.site).
0 commit comments