@threenine/nuxstr-comments

Nuxstr Comments

Enable nostr protocol based comment system on your Nuxt 4 based applications.

• ✨  Release Notes

Features

• Nostr-powered comments for Nuxt Content blog posts
• NIP-07 login prompt if user is not authenticated
• Comments are written in Markdown and rendered via @nuxt/content's ContentRendererMarkdown
• Configurable relay list and tagging strategy

Quick Setup

Install the module to your Nuxt application with one command:

npx nuxi module add @threenine/nuxstr-comments

That's it! You can now use Nuxstr Comments in your Nuxt app ✨

Usage

• Ensure @nuxt/content is enabled and your blog post pages use ContentDoc or render content files.
• Add the comments component where you want comments to appear (usually below a ContentDoc):

<template>
  <div>
    <ContentDoc />
    <NuxstrComments />
  </div>
</template>

By default, the component tags comments by the current route path (e.g., content:/blog/my-post) and fetches them from configured relays.

• Configuration (nuxt.config.ts):

export default defineNuxtConfig({
  modules: [
    '@nuxt/content',
    '@threenine/nuxstr-comments',
  ],
  nuxstrComments: {
    relays: ['wss://relay.damus.io', 'wss://relay.nostr.band'],
    tagStrategy: 'path',
    tagPrefix: 'comment:',
  },
})

Select your preferred relays from the list of relays and configure the tag strategy and tag prefix.

When a user attempts to post, they will be prompted to log in with their Nostr browser extension NIP-07.

Comments are published as kind: 1111 as defined in NIP-22 notes tagged with a t tag containing the content tag (e.g., comment:/blog/my-post).

Replys to comments are enable, and are also published as kind: 1111, as defined in NIP-22

Contribution

Local development

# Install dependencies
npm install

# Generate type stubs
npm run dev:prepare

# Develop with the playground
npm run dev

# Build the playground
npm run dev:build

# Run ESLint
npm run lint

# Run Vitest
npm run test
npm run test:watch

# Release new version
npm run release

Support

⚡️ lightning address:

[e-mail]

Changelog

v1.5.1

compare changes

🩹 Fixes

• ReplyButton: Remove extra spaces in imports and computed property (8bd2dfe)

💅 Refactors

• components: Rename CommentCommandBar to ReplyButton and improve reply UI (1f89445)
• components: Standardize casing in ReplyButton template elements (8726305)
• components: Update spacing and styles in reply-related components (b780258)
• runtime: Update imports and typings for improved consistency (6933618)
• runtime: Standardize useReplies import and improve type annotations (68fd2e2)

📖 Documentation

• README: Update comment configuration and tagging details (73ad389)

❤️ Contributors

• Gary Woodfine [e-mail]