rspress-description-generator

Rspress Description Generator

The description field in Rspress frontmatter generates <meta name="description" content="..."> tags, which are used for search engine snippets, social media previews, and AI-oriented formats like llms.txt.

Step 1 — Locate the docs root

1. Find the Rspress config file. Search for rspress.config.ts, .js, .mjs, or .cjs. It may be at the project root or inside a subdirectory like website/.
2. Read the config and extract the root option.
   • The value might be a plain string (root: 'docs') or a JS expression (root: path.join(__dirname, 'docs')). In either case, determine the resolved directory path.
   • If root is set, resolve it relative to the config file's directory.
   • If root is not set, default to docs relative to the config file's directory.
3. Confirm the directory exists. If neither docs nor the configured root exists, check for doc as a fallback.

Step 2 — Detect i18n structure

Rspress i18n projects place language subdirectories (e.g., en/, zh/) directly under the docs root:

docs/
├── en/
│   ├── guide/
│   └── index.md
└── zh/
    ├── guide/
    └── index.md

Check if the docs root contains language subdirectories (two-letter codes like en, zh, ja, ko, etc.). If so, process each language directory separately — the description language should match the content language.

If there are no language subdirectories, treat the entire docs root as a single-language site.

Step 3 — Scan and process files

Glob for **/*.md and **/*.mdx under the docs root. Exclude:

• node_modules, build output (doc_build, .rspress, dist)
• _meta.json / _nav.json (sidebar/nav config files, not doc pages)
• **/shared/** directories (reusable snippets included via @import, not standalone pages)

For each file:

1. Read the file.
2. Check for existing description in frontmatter. If it exists and is non-empty, skip.
3. Check pageType in frontmatter. For home pages, derive the description from the hero.text / hero.tagline fields or the features list, not from body content.
4. Generate a description following the writing guidelines below.
5. Insert description into frontmatter:
   • If the file has frontmatter with a title field, insert description on the line after title.
   • If the file has frontmatter without title, insert description as the first field.
   • If the file has no frontmatter block, add one: