docs: add seo improvements to microsite

following the #33200 but adding also LD+JSON data, preconnect
for google fonts, robots.txt, and other additional metadata
for the page.

Signed-off-by: Hellgren Heikki <heikki.hellgren@op.fi>
This commit is contained in:
Hellgren Heikki
2026-03-12 10:18:45 +02:00
parent c08e4daf24
commit fa33a33a6a
2 changed files with 78 additions and 0 deletions
+74
View File
@@ -63,11 +63,63 @@ const defaultOpenApiOptions = {
},
} satisfies OpenApiPlugin.Options;
const seoDescription =
'Backstage is an open source developer portal framework that centralizes your software catalog, unifies infrastructure tools, and helps teams ship high-quality code faster.';
const seoKeywords = [
'Backstage',
'developer portal',
'internal developer platform',
'platform engineering',
'software catalog',
'software templates',
'TechDocs',
'developer experience',
'IDP',
'open source',
];
const config: Config = {
title: 'Backstage Software Catalog and Developer Platform',
tagline: 'An open source framework for building developer portals',
url: 'https://backstage.io',
baseUrl: '/',
headTags: [
{
tagName: 'link',
attributes: {
rel: 'preconnect',
href: 'https://fonts.googleapis.com',
},
},
{
tagName: 'link',
attributes: {
rel: 'preconnect',
href: 'https://fonts.gstatic.com',
crossOrigin: 'anonymous',
},
},
{
tagName: 'script',
attributes: {
type: 'application/ld+json',
},
innerHTML: JSON.stringify({
'@context': 'https://schema.org',
'@type': 'WebSite',
name: 'Backstage',
url: 'https://backstage.io',
description: seoDescription,
image: 'https://backstage.io/img/sharing-opengraph.png',
publisher: {
'@type': 'Organization',
name: 'Spotify',
url: 'https://spotify.github.io/',
},
}),
},
],
organizationName: 'Spotify',
projectName: 'backstage',
scripts: [
@@ -330,6 +382,28 @@ const config: Config = {
],
themes: ['docusaurus-theme-openapi-docs'],
themeConfig: {
metadata: [
{
name: 'description',
content: seoDescription,
},
{
name: 'keywords',
content: seoKeywords.join(', '),
},
{
property: 'og:site_name',
content: 'Backstage',
},
{
property: 'og:type',
content: 'website',
},
{
name: 'twitter:card',
content: 'summary_large_image',
},
],
languageTabs: [
{
highlight: 'javascript',
+4
View File
@@ -0,0 +1,4 @@
User-agent: *
Allow: /
Sitemap: https://backstage.io/sitemap.xml