jimray.locket.computer
Add Bluesky replies, quotes, and reposts to any web page. Handy for adding a comments section anywhere.
Clarified a few bits in the README
+4
-17
+4
-17
README.md
+4
-17
README.md
···
2
2
3
3
A zero-dependency web component that displays a Bluesky conversation thread — replies, quote posts, and reposts — for any public Bluesky post. Drop it into any page with a single `<script>` tag.
4
4
5
+
See it live on the [atproto.com blog](https://atproto.com/blog) or a [demo](https://jimray-bsky.tngl.io/bsky-conversation/).
6
+
5
7
## Quick start
6
8
7
9
```html
···
12
14
13
15
That's it. No build step, no dependencies.
14
16
15
-
## Install via npm
16
-
17
-
```bash
18
-
npm install bsky-conversation
19
-
```
20
-
21
-
```js
22
-
// Auto-registers the <bsky-conversation> element
23
-
import 'bsky-conversation'
24
-
25
-
// Or import the class for manual registration
26
-
import { BskyConversation } from 'bsky-conversation'
27
-
customElements.define('my-conversation', BskyConversation)
28
-
```
29
-
30
17
## Attributes
31
18
32
19
| Attribute | Default | Description |
···
39
26
40
27
## Template syntax
41
28
42
-
The `header-template` attribute supports a mini template language.
29
+
The `header-template` attribute supports a mini template language to let you customize how you introduce the conversation on your site.
43
30
44
31
**Simple tokens** — replaced with their value:
45
32
···
126
113
127
114
## Behavior
128
115
129
-
- Fetches from the public Bluesky API (no authentication needed)
116
+
- Fetches directly from the public Bluesky API (no authentication needed)
130
117
- Rich text rendering with proper UTF-8 byte-offset facet handling (links, @mentions, #hashtags)
131
118
- Root post author's direct replies are filtered out (they're extensions of the original post, not conversation)
132
119
- Hidden replies (via threadgate) and detached quotes (via postgate) are filtered out