Getting Started
Install
Section titled “Install”npm install starlight-theme-large-print# optional: one CJK font packnpm install starlight-theme-large-print-font-noto-serif-sc # Simplified Chinesenpm install starlight-theme-large-print-font-noto-serif-tc # Traditional ChineseConfigure
Section titled “Configure”Add the plugin to your Starlight plugins array in astro.config.mjs:
import starlightThemeLargePrint from 'starlight-theme-large-print';
export default defineConfig({ integrations: [ starlight({ plugins: [ starlightThemeLargePrint({ font: 'noto-serif-sc', // 'noto-serif-sc' | 'noto-serif-tc' | false // baseFontSize: '17px', // lineHeight: 1.85, // warmDark: true, }), ], }), ],});Add the font-size control
Section titled “Add the font-size control”The theme does not auto-inject the A− A A+ control (auto-overriding a Starlight component would collide with other themes). Render it in your own Header override, next to <ThemeSelect />:
---import FontSizeControl from 'starlight-theme-large-print/components/FontSizeControl.astro';---
<FontSizeControl />Options
Section titled “Options”| Option | Default | Description |
|---|---|---|
font |
false |
'noto-serif-sc' | 'noto-serif-tc' | false. Requires the matching font package. |
baseFontSize |
'17px' |
Base body font size; readers can override it with the font-size control. |
lineHeight |
1.85 |
Body line height. |
warmDark |
true |
Warm paper-tone dark mode background. |