displacement: build on MarshalX/atproto SDK, don't hand-author the atproto plumbing #24

New issue

Closed

opened 2026-06-17 08:40:17 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-06-17 08:40:17 +00:00

Owner

Displacement: adopt MarshalX/atproto for the reserved plumbing (don't hand-write it)

From the 2026-06-17 full-fleet displacement scout.

atmosphere's stated reason-for-being is shared AT Protocol plumbing across apps: lexicon definitions, identity/auth, a PDS client, a Jetstream firehose consumer. All four are covered directly by MarshalX/atproto (~653 stars, v0.0.68 June 2026, 67 releases, MIT, async, type-hinted): auto-generated lexicon models, DID/handle resolvers, XRPC/PDS client, firehose streaming. For Jetstream specifically, bluesky-social/jetstream (official, Go, self-hostable) is the JSON-stream option.

Action

packages/atproto-core is currently empty/reserved. When building it, make packages/ a thin app-specific layer ON TOP of the atproto SDK - do not author your own identity/auth/PDS/firehose stack. That would be textbook NIH against a mature SDK.
ideas/ + apps/ stay custom (they're the experiments, not plumbing).

Pre-emptive: nothing to retire yet (empty incubator), so this costs nothing now and saves a large hand-written SDK later. Highest-ROI finding of the sweep. Run supply-chain-audit + pin before adding the dep.

## Displacement: adopt MarshalX/atproto for the reserved plumbing (don't hand-write it) From the 2026-06-17 full-fleet displacement scout. atmosphere's stated reason-for-being is shared AT Protocol plumbing across apps: lexicon definitions, identity/auth, a PDS client, a Jetstream firehose consumer. All four are covered directly by [`MarshalX/atproto`](https://github.com/MarshalX/atproto) (~653 stars, v0.0.68 June 2026, 67 releases, MIT, async, type-hinted): auto-generated lexicon models, DID/handle resolvers, XRPC/PDS client, firehose streaming. For Jetstream specifically, [`bluesky-social/jetstream`](https://github.com/bluesky-social/jetstream) (official, Go, self-hostable) is the JSON-stream option. ### Action - `packages/atproto-core` is currently empty/reserved. When building it, make `packages/` a thin app-specific layer ON TOP of the `atproto` SDK - do not author your own identity/auth/PDS/firehose stack. That would be textbook NIH against a mature SDK. - `ideas/` + `apps/` stay custom (they're the experiments, not plumbing). Pre-emptive: nothing to retire yet (empty incubator), so this costs nothing now and saves a large hand-written SDK later. Highest-ROI finding of the sweep. Run supply-chain-audit + pin before adding the dep.

coilysiren commented

2026-06-17 18:52:39 +00:00

Author

Owner

Closing. atmosphere (AT Protocol incubator) is archived in the June 2026 surface reduction.

coilysiren closed this issue

2026-06-17 18:52:39 +00:00

Commenting is not possible because the repository is archived.