@karaoke-cms/module-tags

Tags module for karaoke-cms — cross-collection tag index with per-tag RSS feeds. Aggregates tags from your blog and all active docs sections automatically.

Installation

npm install @karaoke-cms/module-tags

Usage

// karaoke.config.ts
import { defineConfig } from '@karaoke-cms/astro';
import { tags } from '@karaoke-cms/module-tags';

export default defineConfig({
  // ...
  modules: [tags()],
});

No options required. Once added, your site gets /tags, /tags/[tag], and /tags/[tag]/rss.xml automatically.

Configuration

| Option | Type | Default | Description | |--------|------|---------|-------------| | mount | string | '/tags' | URL prefix for all tag routes | | enabled | boolean | true | Set false to disable without removing from config |

Routes

| Pattern | Description | |---------|-------------| | /tags | All-tags listing — every tag with post count | | /tags/[tag] | Posts and docs matching a single tag | | /tags/[tag]/rss.xml | RSS feed for a single tag |

Frontmatter

Tags are read from the tags field on blog posts and docs pages:

---
title: My Post
publish: true
tags: [javascript, tutorial]
---

No additional frontmatter fields are added by this module.

What's new in 0.18.0

• Dynamic content source indexing — the tags module now discovers and indexes all enabled content sources (blog and every active docs section) automatically, instead of querying a hardcoded blog collection. Adding or removing modules updates the tag index without any config changes.

What's new in 0.13.1

No user-facing changes in this release.

What's new in 0.13.0

• Initial release — /tags, /tags/[tag], and per-tag RSS feeds; aggregates tags from blog and all active docs sections automatically; mount and enabled options