feat(seo): BreadcrumbList markup + repair stale Learn links

[Tatenda]

Why

Search Console's Enhancements section only reports structured-data types that produce rich results. The site emits WebSite, Organization and Article JSON-LD — none of which appear there. BreadcrumbList does, and it lets Google show the breadcrumb trail in results instead of a bare URL.

What

BreadcrumbList on guides (/:slug) — Learn → cluster → article, built from the same values as the visible <nav> so the markup and the rendered trail can't drift.

BreadcrumbList on tool pages — Home → Tools → <tool>, emitted only from the standard layout. The fullscreen layout renders no breadcrumb, so claiming one there would be a false structured-data claim. Both registered tools are currently fullscreen: true, so this is inert until a non-fullscreen tool ships.

Bug fix: stale links from the /learn restructure

The breadcrumb couldn't be marked up correctly without fixing these first — they were pointing at URLs that no longer do what they say:

Location	Was	Now
Article breadcrumb "Learn"	/ (landing page)	/learn
Article cluster filter (×2)	/?cluster=<id>	/learn?view=grid&cluster=<id>
Article JSON-LD isPartOf	/?cluster=<id>	/learn?view=grid&cluster=<id>
"All topics" sidebar link	/	/learn
ChatSidebar cluster link	/?cluster=	/learn?view=grid&cluster=

/?cluster=<id> silently filtered nothing — the landing page ignores that param.

Verification

Created a temporary published article, confirmed the emitted JSON-LD:

{"@type":"BreadcrumbList","itemListElement":[
  {"position":1,"name":"Learn","item":"https://flemoji.com/learn"},
  {"position":2,"name":"Music Royalties for Independent Artists","item":"https://flemoji.com/learn?view=grid&cluster=…"},
  {"position":3,"name":"TEMP breadcrumb verification","item":"https://flemoji.com/temp-breadcrumb-verification"}
]}

Rendered links match exactly. Temp article deleted; database back to zero published articles.

tsc 0 errors · lint 0 errors · jest 337/337.

Note

This produces no visible Search Console enhancement until guides are published — there are currently zero.

🤖 Generated with Claude Code

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
music-next	Ready	Preview	Aug 4, 2026 5:27pm

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 87b3974b-6dc2-4b2a-8ae1-21f01729754a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}