Skip to content

feat: agent friendly website#3304

Open
zehfernandes wants to merge 5 commits intocanaryfrom
feat/agent-friendly
Open

feat: agent friendly website#3304
zehfernandes wants to merge 5 commits intocanaryfrom
feat/agent-friendly

Conversation

@zehfernandes
Copy link
Copy Markdown
Contributor

@zehfernandes zehfernandes commented Apr 16, 2026


Summary by cubic

Make the site friendlier for agents and LLMs with structured data, plaintext endpoints, updated robots rules, and a richer sitemap. Improves discoverability of components and editor examples across tools.

  • New Features

    • Added schema.org JSON-LD across the site: Organization/WebSite (in layout.tsx), CollectionPage/ItemList (on /components), and SoftwareSourceCode (on component category pages).
    • Added plaintext catalogs at GET /llms.txt and GET /llms-full.txt with 24h caching.
    • Updated robots and expanded sitemap.xml: allow common LLM crawlers and include /templates, all component categories, and editor example routes.
  • Refactors

    • Centralized editor example sections/slugs in editor-examples-data.ts used by both the page and sitemap to avoid drift; fixes the missing custom-theme example in the sitemap.
    • Fixed biome lint and formatting in the sitemap and llms-full.txt route.

Written for commit 21ab100. Summary will update on new commits.

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 16, 2026

⚠️ No Changeset found

Latest commit: 21ab100

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 16, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
react-email Ready Ready Preview, Comment Apr 16, 2026 10:08pm
react-email-demo Ready Ready Preview, Comment Apr 16, 2026 10:08pm

Request Review

Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 7 files

Confidence score: 4/5

  • This PR is likely safe to merge, with only a minor maintainability risk from duplicating the editor example slugs in apps/web/src/app/sitemap.ts.
  • The main concern is drift between this hardcoded list and the real examples source, which could make sitemap entries stale or inconsistent over time.
  • Given the low severity (4/10) and non-immediate runtime impact, this looks like a manageable follow-up rather than a merge blocker.
  • Pay close attention to apps/web/src/app/sitemap.ts - duplicated slug definitions can diverge from the examples page data.
Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="apps/web/src/app/sitemap.ts">

<violation number="1" location="apps/web/src/app/sitemap.ts:5">
P2: This adds a duplicated hardcoded slug list for editor examples, creating a second source of truth that can drift from the actual examples page.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.

Comment thread apps/web/src/app/sitemap.ts Outdated
Move the hardcoded editor example sections/slugs into a shared
editor-examples-data.ts module. Both page.tsx and sitemap.ts now
import from this single source of truth, eliminating the duplicated
slug list that could drift out of sync.

Also fixes a missing 'custom-theme' slug that was present in the
examples page but absent from the sitemap.

Co-authored-by: Zeh Fernandes <ozehfernandes@gmail.com>
- Fix import ordering in sitemap.ts (organizeImports)
- Fix line length formatting in llms-full.txt/route.ts

Co-authored-by: Zeh Fernandes <ozehfernandes@gmail.com>
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.

2 participants