---
name: bijection-comments-vllnt
description: "Evaluate and integrate the Comments Vllnt component with Bijection."
---

# Comments Vllnt

Threaded comments / annotations on any resource — post, reply, edit, resolve, and soft-delete as a Bijection component

- Package: @bijectionhq/comments-vllnt
- Category: Collaboration
- Status: Reference
- License: MIT
- Bijection source (repository access required): https://github.com/bijectionhq/comments-vllnt/tree/c6348ee5d866861822d637ccfbd023d0cd8f4ad4
- Upstream: https://github.com/vllnt/convex-comments/tree/7afe107f139a49f10605cc8916c83b7185911383
- Documentation: https://docs.bijection.com/components/using
- Directory: https://bijection.com/components/comments-vllnt

## Get the source

Bijection repository access is required. Request access at https://bijection.com/contact.

```sh
git clone https://github.com/bijectionhq/comments-vllnt.git
cd comments-vllnt
git checkout c6348ee5d866861822d637ccfbd023d0cd8f4ad4
```

## Before using this component

Read the package README at the recorded revision for setup, dependencies, and API examples. Upstream documentation describes the original package and may differ from the Bijection adaptation. This is a source candidate for evaluation. Catalog inclusion does not establish npm availability or runtime qualification. Check compatibility with your SDK and deployment before adoption. External providers run their own compute.

## Integration workflow

1. Read the source README and package manifest at the recorded revision.
2. Confirm the required SDK, dependency availability, and runtime compatibility.
3. Follow the component's documented setup and configuration. Never invent an npm install command from a catalog package name.
4. Keep credentials in the project's existing secret store.
5. Follow the project's execution rules for verification and report what was actually checked.

## Original upstream skill

The following guidance describes @vllnt/convex-comments. Its installation commands and APIs refer to the upstream package. Evaluate compatibility with the Bijection source separately.


> Agents: read this skill fully before writing code that uses Comments. Follow the installation and configuration steps exactly.

# Comments

## Instructions

@vllnt/convex-comments attaches discussions to any resource your application identifies. The host supplies resource and author references plus a typed body, keeping the component independent of a specific content model.

post creates a comment or a same-resource reply. list paginates threads, count reports visible comments, and edit, remove, and resolve support author operations. Soft deletion clears the body while retaining the thread structure until retention cleanup. Host Convex queries can expose reactive updates.

Your backend authenticates the author, controls resource access, and supplies trusted author references. It also owns moderation and safe rendering of text or rich content. Authorship checks compare supplied references; they do not authenticate a caller on their own.

Maintained by [bntvllnt](https://bntvllnt.com) at [VLLNT](https://vllnt.com). Find the author on [GitHub](https://github.com/bntvllnt) and [X](https://x.com/bntvllnt).

### Installation

```bash
npm install @vllnt/convex-comments
```

Current npm version: `@vllnt/convex-comments@0.1.0`

## Use cases

- Document tools: attach comments and replies to a document or host-defined annotation target.
- Learning platforms: add questions and discussions to lessons.
- Communities: build threaded replies under posts or user creations.
- Games: collect discussion around shared results, maps, or guides.

## How it works

post creates a comment or a same-resource reply. list paginates threads, count reports visible comments, and edit, remove, and resolve support author operations. Soft deletion clears the body while retaining the thread structure until retention cleanup. Host Convex queries can expose reactive updates.

Your backend authenticates the author, controls resource access, and supplies trusted author references. It also owns moderation and safe rendering of text or rich content. Authorship checks compare supplied references; they do not authenticate a caller on their own.

## When NOT to use

- When a simpler built-in solution exists for your specific use case
- If you are not using Convex as your backend
- When the functionality provided by Comments is not needed

## Resources

- [npm package](https://www.npmjs.com/package/%40vllnt%2Fconvex-comments)
- [GitHub repository](https://github.com/vllnt/convex-comments)
- [Live demo](https://vllnt.com/)
- [Convex Components Directory](https://www.convex.dev/components/vllnt/convex-comments)
- [Convex documentation](https://docs.convex.dev)