Themes

shikiphp bundles the full Shiki theme set: all 65 VS Code themes from tm-themes 1.12.2, the set Shiki 3.23.0 ships. 44 are dark and 21 are light. Popular ids include github-dark, github-light, nord, dracula, vitesse-dark, vitesse-light, one-dark-pro, monokai, solarized-dark, and the catppuccin-* and material-theme-* families.

Use a single theme with the theme option, or two (or more) with themes for light/dark CSS-variable output. See Getting Started.

use Shikiphp\Shikiphp;

echo Shikiphp::codeToHtml('const answer = 42', [
    'lang'   => 'js',
    'themes' => ['light' => 'github-light', 'dark' => 'github-dark'],
]);

A theme id the bundle does not know throws Shikiphp\Exceptions\Highlight with the message Unknown theme "…".

What a theme controls

A theme sets the block's foreground and background (written on the <pre>) and the color and font style (italic, bold, underline, strikethrough) of every token, resolved by scope-selector specificity. For lang: 'ansi' its terminal.ansi* colors become the ANSI palette (see ANSI). To adjust individual colors without editing a theme, use colorReplacements.

Listing the bundled themes

From PHP:

use Shikiphp\Shikiphp;

$highlighter = Shikiphp::highlighter();

$highlighter->bundledThemes(); // list<string> — ids shipped in the box
$highlighter->loadedThemes();  // list<string> — bundled plus any you registered

Or from the command line, one id per line in alphabetical order:

vendor/bin/shikiphp themes

Catalog

The type is the light or dark type the bundle records for each theme, useful when picking a pair for the themes option.

Adding your own

Register a custom VS Code theme JSON with loadTheme. See Custom languages and themes.