diff --git a/docs/content/4. integrations/.navigation.yml b/docs/content/4. integrations/.navigation.yml new file mode 100644 index 000000000..f2626af07 --- /dev/null +++ b/docs/content/4. integrations/.navigation.yml @@ -0,0 +1,2 @@ +title: Integrations +icon: i-lucide-cable diff --git a/docs/content/4. integrations/1.atmosphere.md b/docs/content/4. integrations/1.atmosphere.md new file mode 100644 index 000000000..c04a062bc --- /dev/null +++ b/docs/content/4. integrations/1.atmosphere.md @@ -0,0 +1,89 @@ +--- +title: Atmosphere +description: npmx.dev's role in the Atmosphere +navigation: + icon: i-lucide-cloudy +--- + + + + +## Overview + +_npmx.dev_ site architecture as it pertains to the ATProtocol ecosystem, the [Atmosphere](https://atproto.com/). + +--- + +## Atmosphere + +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: + +> The AT Protocol is an open, decentralized network for building social applications. + +--- + +## Architecture + +These are the components that allow for _npmx.dev_ to exist as an app on the Atmosphere: + +1. **Domain** - _npmx.dev_ site +2. **OAuth** - Required for interacting with the Atmosphere +3. **Constellation** - A global atproto backlink index +4. **Lexicons** - Schema definition language +5. **Standard Site Sync** - Synchronizes app data with PDS +6. **Bluesky Social Graph** - Consume Bluesky posts/comments/threads + +### Domain + +_npmx.dev_ site which serves as a third-party browser prioritized around high DX and native-like performance... + +### OAuth + +Necessary to ensure identities are observed... + +> OAuth is the primary mechanism in atproto for clients to make authorized requests to PDS instances. + +https://atproto.com/specs/oauth + +### Constellation + +Orchestration API layer that collects...stuff... + +### Lexicons + +Orchestration API layer that collects...stuff... + +> Lexicon is a schema definition language used to describe atproto records, HTTP endpoints (XRPC), and event stream messages. + +https://atproto.com/specs/lexicon + +### Standard Site Sync + +Synchronizes data changes from npmx.dev in the form of blog post MD files... + +### Bluesky Social Graph + +Collects and generates events to utilize Posts/Comments/Threads + +--- + +## How & Why the Atmosphere + +These are the components that allow for _npmx.dev_ to exist as an app on the Atmosphere: + +1. **Blog Posts** - Share short and long form thought from the people behind the app +2. **Comments** - Allows people to share their thoughts and feelings +3. **Awareness** - Raises brand awareness +4. **Engagement** - Promotes brand engagement + +--- + +## Resources + +These are the components that allow for _npmx.dev_ to exist as an app on the Atmosphere: + +- **ATProtocol Docs** - [Introduction](https://atproto.com) +- **Constellation Repo** - [readme.md](https://github.com/at-microcosm/microcosm-rs/tree/main/constellation) +- **Bluesky** - [Disocover Page](https://bsky.app/) + +---