Skip to content

[haxcms-nodejs] Add llms discoverability metadata to NodeJS templates#13

Draft
Copilot wants to merge 2 commits into
mainfrom
copilot/add-llms-for-nodejs-templates
Draft

[haxcms-nodejs] Add llms discoverability metadata to NodeJS templates#13
Copilot wants to merge 2 commits into
mainfrom
copilot/add-llms-for-nodejs-templates

Conversation

Copy link
Copy Markdown

Copilot AI commented May 15, 2026

Related Issue

Figma Link

Description of Changes

NodeJS boilerplate templates already generated llms.txt but did not advertise it in crawler/consumer-facing metadata. This updates the template layer so generated sites expose llms.txt consistently in HTML head metadata and robots.txt.

What changed:

  • Template head discoverability
    • Added <link rel="alternate" type="text/markdown" ...> for llms.txt in:
      • src/boilerplate/site/index.html
      • src/boilerplate/site/ghpages.html
      • src/boilerplate/site/config.php (PHP-rendered metadata path)
  • Robots discoverability
    • Updated src/boilerplate/site/robots.txt (non-private branch) to include:
      • Sitemap: {{ basePath }}sitemap.xml
      • LLMS: {{ basePath }}llms.txt
      • explicit Allow: /
  • Scope
    • No runtime routing/model changes; only managed boilerplate template output changed.

Why this change was needed:

The issue requested parity for NodeJS templates: generated sites should not just produce llms.txt, they should also signal it through standard discoverability surfaces used by crawlers and LLM-facing tooling.

<link rel="alternate" type="text/markdown" href="llms.txt" title="LLMs index" />

Type of Change

  • 🐛 Bug fix (non-breaking change which fixes an issue)
  • ✨ New feature (non-breaking change which adds functionality)
  • 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • 📚 Documentation update
  • 🎨 Style/formatting changes
  • ♻️ Code refactoring
  • 🔧 Configuration changes

Testing Checklist

  • I have tested this change locally
  • I have added/updated tests for my changes
  • All existing tests pass
  • I have tested on multiple browsers (if applicable)
  • I have tested on mobile devices (if applicable)
  • I have verified accessibility compliance
  • I have tested with screen readers (if applicable)

Quality Assurance

  • I have followed the project's coding conventions
  • I have updated documentation where necessary
  • I have added comments to complex code
  • My changes don't introduce console warnings/errors
  • I have checked for performance implications

Ways to Test This Change

  1. Generate/rebuild a site from NodeJS boilerplate.
  2. Open generated index.html (or rendered head output) and verify llms.txt alternate link tag is present.
  3. Open generated robots.txt and verify Sitemap and LLMS directives resolve against basePath.

Screenshots/Recordings

Before:

llms.txt was generated but not advertised in template head metadata or robots.txt.

After:

Generated templates now include head-level llms.txt alternate metadata and robots.txt LLMS/Sitemap directives.

Additional Notes

Parallel review flagged minor style consistency suggestions (e.g., relative URL style); behaviorally this PR stays minimal and focused on discoverability parity.

Checklist

  • I have read the contributing guidelines
  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • Any dependent changes have been merged and published

Copilot AI linked an issue May 15, 2026 that may be closed by this pull request
Copilot AI changed the title [WIP] Add LLMS support for Node.js templates [haxcms-nodejs] Add llms discoverability metadata to NodeJS templates May 15, 2026
Copilot finished work on behalf of btopro May 15, 2026 02:19
Copilot AI requested a review from btopro May 15, 2026 02:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Llms for nodejs templates

2 participants