Skip to content

Commit 6ceec16

Browse files
emrulclaude
andcommitted
feat(docs): accessibility + SEO fixes
Accessibility: global :focus-visible outlines, id="main-content" on all custom pages. SEO: robots.txt, JSON-LD WebSite schema, Geist font preload. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 451d3f8 commit 6ceec16

6 files changed

Lines changed: 46 additions & 3 deletions

File tree

docusaurus.config.ts

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,35 @@ const config: Config = {
3232

3333
onBrokenLinks: 'throw',
3434

35+
headTags: [
36+
{
37+
tagName: 'link',
38+
attributes: {
39+
rel: 'preload',
40+
as: 'font',
41+
type: 'font/ttf',
42+
href: '/fonts/geist/Geist-VariableFont_wght.ttf',
43+
crossorigin: 'anonymous',
44+
},
45+
},
46+
{
47+
tagName: 'script',
48+
attributes: { type: 'application/ld+json' },
49+
innerHTML: JSON.stringify({
50+
'@context': 'https://schema.org',
51+
'@type': 'WebSite',
52+
name: 'Aster Docs',
53+
url: 'https://docs.aster.site',
54+
description: 'Documentation for Aster — peer-to-peer RPC framework with cryptographic identity.',
55+
publisher: {
56+
'@type': 'Organization',
57+
name: 'Aster',
58+
url: 'https://aster.site',
59+
},
60+
}),
61+
},
62+
],
63+
3564
// Even if you don't use internationalization, you can use this field to set
3665
// useful metadata like html lang. For example, if your site is Chinese, you
3766
// may want to replace "en" with "zh-Hans".

src/css/custom.css

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2470,3 +2470,13 @@ html[data-theme='light'] .asterSignalPanel__meta span {
24702470
0%, 48% { opacity: 1; }
24712471
49%, 100% { opacity: 0; }
24722472
}
2473+
2474+
/* ── Accessibility: focus-visible ──────────────────────────────────────── */
2475+
a:focus-visible,
2476+
button:focus-visible,
2477+
[role="button"]:focus-visible,
2478+
[tabindex]:focus-visible {
2479+
outline: 2px solid var(--aster-teal);
2480+
outline-offset: 3px;
2481+
border-radius: 4px;
2482+
}

src/pages/index.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -364,7 +364,7 @@ export default function Home(): React.JSX.Element {
364364
<Layout
365365
title="Machines authenticate to machines, on behalf of users."
366366
description="Peer-to-peer RPC framework with identity in the connection. Capability-based auth, cross-language wire format, built on iroh QUIC.">
367-
<main className="asterHome">
367+
<main id="main-content" className="asterHome">
368368
<section className="asterHero">
369369
<div className="container asterHero__container">
370370
<div className="asterHero__content">

src/pages/terminal-demo.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ export default function TerminalDemo(): React.JSX.Element {
88
<Layout
99
title="Terminal Animation Demo"
1010
description="Isolated Aster terminal animation prototype driven by a polished asciicast recording.">
11-
<main className="asterHome asterTerminalDemoPage">
11+
<main id="main-content" className="asterHome asterTerminalDemoPage">
1212
<section className="asterSection">
1313
<div className="container">
1414
<div className="asterTerminalDemoPage__header">

src/pages/terminal-landing.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ export default function TerminalLanding(): React.JSX.Element {
9191
<Layout
9292
title="Terminal Landing Prototype"
9393
description="Alternative Aster landing page concept using a focused terminal animation hero.">
94-
<main className="asterHome asterTerminalLandingPage">
94+
<main id="main-content" className="asterHome asterTerminalLandingPage">
9595
<section className="asterTerminalLandingHero">
9696
<div className="container asterTerminalLandingHero__container">
9797
<div className="asterTerminalLandingHero__copy">

static/robots.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
User-agent: *
2+
Allow: /
3+
4+
Sitemap: https://docs.aster.site/sitemap.xml

0 commit comments

Comments
 (0)