arborium

Batteries-included tree-sitter grammar collection with HTML rendering and WASM support.

Quick Start

As a Rust library

cargo add arborium

By default, all permissively-licensed grammars are included (~70 languages). To select specific languages:

cargo add arborium --no-default-features --features lang-rust,lang-javascript

As a CLI tool

cargo install arborium-cli
arborium file.rs  # Syntax highlight in your terminal

In the browser

<script src="https://cdn.jsdelivr.net/npm/@arborium/arborium@2/dist/arborium.iife.js"></script>
<!-- Auto-highlights all code blocks! -->

Features

~70 language grammars included out of the box
Permissively licensed (MIT/Apache-2.0/CC0/Unlicense) grammars enabled by default
WASM support with custom allocator fix
HTML rendering with 32 built-in themes
Browser usage via drop-in script tag or ESM module
CLI tool (arborium-cli) - syntax highlighting for terminal and HTML
Feature flags for fine-grained control over included languages

Documentation

For complete documentation including:

Full language support list
Browser usage guide (drop-in script, ESM modules, compile to WASM)
All 32 built-in themes
HTML tag reference
WASM build instructions
Feature flags reference

See the arborium crate on crates.io or docs.rs.

Repository Structure

crates/arborium/ - Main umbrella crate (start here!)
crates/arborium-cli/ - Terminal syntax highlighter CLI
crates/arborium-*/ - Individual language grammar crates (~100 crates)
packages/arborium/ - NPM package for browser use
xtask/ - Build automation and code generation

Co-developed with LLMs

This project was co-developed with LLMs such as Claude, Codex, etc. Human
maintainers are responsible for their contributions regardless of machine help.

License

This project is dual-licensed under MIT OR Apache-2.0.

The bundled grammar sources retain their original licenses - see LICENSES.md for details.

Development

This project uses cargo xtask for most development and release tasks.

For detailed architecture, workflows, publishing order, and layout, see DEVELOP.md.

For a quick overview of available commands, run:

cargo xtask help

bearcove/arborium