feat(site): framework-specific SEO metadata for docs#541
Merged
Conversation
Automatically generate framework-aware titles and descriptions for all docs pages using the existing FRAMEWORK_LABELS map and route context. Before: "Play Button | Docs | Video.js 10" After: "Play Button | React Video Player | Video.js 10" Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
✅ Deploy Preview for vjs10-site ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
📦 Bundle Size Report
Total: 34.51 kB · 0 B · 0% Entry BreakdownSubpath sizes are the additional bytes on top of the root entry point, measured by bundling root + subpath together and subtracting the root-only size.
|
| Entry | Base | PR | Diff | % | |
|---|---|---|---|---|---|
. |
2.77 kB | 2.77 kB | 0 B | 0% | ✅ |
./dom |
2.60 kB | 2.60 kB | 0 B | 0% | ✅ |
| total | 5.37 kB | 5.37 kB | 0 B | 0% |
@videojs/element
| Entry | Base | PR | Diff | % | |
|---|---|---|---|---|---|
. |
817 B | 817 B | 0 B | 0% | ✅ |
./context |
823 B | 823 B | 0 B | 0% | ✅ |
| total | 1.60 kB | 1.60 kB | 0 B | 0% |
@videojs/icons
| Entry | Base | PR | Diff | % | |
|---|---|---|---|---|---|
./react |
4.77 kB | 4.77 kB | 0 B | 0% | ✅ |
./html |
1.64 kB | 1.64 kB | 0 B | 0% | ✅ |
| total | 6.40 kB | 6.40 kB | 0 B | 0% |
@videojs/react
| Entry | Base | PR | Diff | % | |
|---|---|---|---|---|---|
. |
7.67 kB | 7.67 kB | 0 B | 0% | ✅ |
./audio |
267 B | 267 B | 0 B | 0% | ✅ |
./background |
40 B | 40 B | 0 B | 0% | ✅ |
./video |
244 B | 244 B | 0 B | 0% | ✅ |
| total | 8.20 kB | 8.20 kB | 0 B | 0% |
@videojs/store
| Entry | Base | PR | Diff | % | |
|---|---|---|---|---|---|
. |
1.29 kB | 1.29 kB | 0 B | 0% | ✅ |
./html |
468 B | 468 B | 0 B | 0% | ✅ |
./react |
199 B | 199 B | 0 B | 0% | ✅ |
| total | 1.94 kB | 1.94 kB | 0 B | 0% |
@videojs/utils
| Entry | Base | PR | Diff | % | |
|---|---|---|---|---|---|
./array |
104 B | 104 B | 0 B | 0% | ✅ |
./dom |
684 B | 684 B | 0 B | 0% | ✅ |
./events |
227 B | 227 B | 0 B | 0% | ✅ |
./function |
197 B | 197 B | 0 B | 0% | ✅ |
./object |
119 B | 119 B | 0 B | 0% | ✅ |
./predicate |
265 B | 265 B | 0 B | 0% | ✅ |
./string |
110 B | 110 B | 0 B | 0% | ✅ |
./style |
63 B | 63 B | 0 B | 0% | ✅ |
./time |
478 B | 478 B | 0 B | 0% | ✅ |
./number |
158 B | 158 B | 0 B | 0% | ✅ |
| total | 2.35 kB | 2.35 kB | 0 B | 0% |
ℹ️ How to interpret
Sizes are minified + brotli, measured with esbuild.
Package totals are computed as root size + marginal subpath costs.
Subpath marginal cost = (root + subpath bundled together) − root alone.
| Icon | Meaning |
|---|---|
| ✅ | No change |
| 🔺 | Increased ≤ 10% |
| 🔴 | Increased > 10% |
| 🔽 | Decreased |
| 🆕 | New (no baseline) |
Run pnpm size locally to check current sizes.
Update SITE_TITLE, SITE_DESCRIPTION, page descriptions, and body content to target high-value search terms like "open source video player", "React video player", and "HTML video player". Add framework-specific intro to installation page and SoftwareApplication structured data to JSON-LD TechArticle schema. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Split SITE_TITLE into brand name ("Video.js") and SEO suffix
("Open Source Video Player"). Docs pages inject the framework name
into the suffix ("Open Source React Video Player"). Keeps all titles
under 60 characters so keywords aren't truncated in search results.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
closes #340
Summary
Adds SEO keyword targeting across the site so high-value search terms like "open source video player", "React video player", and "HTML video player" appear in page titles, meta descriptions, and body content.
Before → After examples
Page titles — pattern:
PAGE | Video.js | Open Source [Framework] Video PlayerVideo.js 10Video.js | Open Source Video PlayerPlayButton | Docs | Video.js 10PlayButton | Video.js | Open Source React Video Playermedia-play-button | Docs | Video.js 10media-play-button | Video.js | Open Source HTML Video PlayerBlog | Video.js 10Blog | Video.js | Open Source Video PlayerMeta descriptions:
Body content — Installation page now shows framework-specific intros:
Changes
consts.ts— SplitSITE_TITLEinto brand name (Video.js) andSEO_SUFFIX(Open Source Video Player); updatedSITE_DESCRIPTIONBase.astro— Newsuffixprop for page title construction:Page | Video.js | suffix. Defaults toSEO_SUFFIX, docs pages override with framework-specific suffixDocs.astro— Passessuffix="Open Source ${framework} Video Player"to Base, injects framework into title and descriptionindex.astro— Homepage subtitle matches new site descriptioninstallation.mdx— Framework-specific intro via<FrameworkCase>, updated descriptiondescriptionfrontmatter to remove "Video.js v10" version references, add benefit language (accessible, customizable, keyboard support)blog/[...page].astro— Updated description in layout prop and visible subtitleschemas.ts— Addedabout: SoftwareApplicationto JSON-LD TechArticle schema, updated blog collection descriptionTest plan
pnpm -F site buildpassesPage | Video.js | Open Source [Framework] Video Playerpattern<meta name="description">includes framework-specific suffix on docs pagesVideo.js | Open Source Video PlayerframeworkTitleoverrides still apply to the first title segment🤖 Generated with Claude Code