@arborium/arborium

High-performance syntax highlighting powered by tree-sitter and WebAssembly.

Installation

npm install @arborium/arborium

Usage

Option 1: Drop-in Script (Easiest)

Add a single script tag and arborium auto-highlights all code blocks:

<script src="https://cdn.jsdelivr.net/npm/@arborium/arborium/dist/arborium.iife.js"></script>

That's it! Arborium will:

• Auto-detect languages from class="language-*" or data-lang="*" attributes
• Load grammar WASM plugins on-demand from jsDelivr CDN
• Inject the default theme CSS

Configuration via data attributes:

<script
  src="https://cdn.jsdelivr.net/npm/@arborium/arborium/dist/arborium.iife.js"
  data-theme="tokyo-night"
  data-selector="pre code"
></script>

Option 2: ESM Module (Programmatic)

import { loadGrammar, highlight } from '@arborium/arborium';

// Load a grammar (fetched from CDN on first use)
const grammar = await loadGrammar('rust');

// Highlight code
const html = grammar.highlight('fn main() { println!("Hello!"); }');

// Or use the convenience function
const html = await highlight('rust', code);

Themes

This package includes 33 built-in themes. Import them individually:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@arborium/arborium/dist/themes/tokyo-night.css">

Or import in JavaScript:

import '@arborium/arborium/themes/tokyo-night.css';

Available Themes

Dark themes: catppuccin-mocha, catppuccin-macchiato, catppuccin-frappe, dracula, evergarden-fall, tokyo-night, nord, one-dark, github-dark, gruvbox-dark, monokai, kanagawa-dragon, rose-pine-moon, ayu-dark, solarized-dark, ef-melissa-dark, melange-dark, cobalt2, zenburn, desert256, rustdoc-dark, rustdoc-ayu

Light themes: catppuccin-latte, github-light, gruvbox-light, ayu-light, solarized-light, melange-light, light-owl, lucius-light, dayfox, alabaster, rustdoc-light

Theme Attribution

All themes are adaptations of color schemes from their original projects. We are grateful to the original theme authors:

Links

• GitHub Repository
• Documentation
• Rust Crate (arborium)

License

MIT OR Apache-2.0

The bundled themes are adaptations of color schemes from their respective projects. Please see each project's repository for their specific licensing terms.