Astryx Design System

Syntax Theme@xds/core v0.0.14 · XDSSyntaxTheme

Usage

Applies syntax highlighting colors to XDSCodeBlock and any code component in the subtree. By default, code components use the theme-level syntax colors (set via defineTheme({ syntax: ... })), which derive from the palette (--color-text-accent for keywords, --color-text-green for strings, etc.). XDSSyntaxTheme lets you override those per-region. The system uses 14 semantic tokens (keyword, string, comment, number, function, type, variable, operator, constant, tag, attribute, property, punctuation, background) validated against 11 community themes. Custom themes are created with defineSyntaxTheme() and can use [light, dark] tuples for automatic color-scheme adaptation. Built-in presets: oneDarkPro, dracula, monokai, nord, tokyoNight, catppuccinMocha, githubLight, githubDark, solarizedLight, oneLight (import from @xds/core/theme/syntax).

ts
import {XDSSyntaxTheme} from '@xds/core/theme'

Best practices

Guidance	Practices
Do	Use the syntax field in defineTheme() for app-wide code styling. Use XDSSyntaxTheme only when a specific section needs a different look.
Do	Pick from built-in presets or create a custom theme with defineSyntaxTheme() for brand-specific colors.
Do	Syntax themes support light-dark() tuples — each token can have different values for light and dark mode, resolved automatically by the color scheme.
Don't	Wrap individual CodeBlock instances with XDSSyntaxTheme — use the syntaxTheme prop on XDSCodeBlock directly for per-instance overrides.

Examples

Common configurations, variations, and states.

SyntaxTheme — Dark Preset

Wrap a code block in XDSSyntaxTheme to apply a dark syntax preset such as Dracula.

SyntaxTheme — Light Preset

Use a light syntax preset for code examples that need to sit on light documentation surfaces.