Plugin development

For authors extending BokeBox. License LGPL-3.0 — keep attribution.

Start here

• Examples catalog — repo examples/
• Install & manage — copy / zip / rescan / toggle

Paths

Goal	Doc	Example
New content source	Source plugins	source-plugin-echo
New ASR provider	ASR plugins	asr-plugin-echo
New TTS provider	TTS plugins	tts-plugin-echo · fishspeech
Timed candidates	Schedule plugins	schedule-plugin-echo
Web visual tokens	Design Tokens	apps/web/src/styles/index.css

Conventions

• Dir: storage/plugins/<kind>/<dir>/plugin.json + ESM entry
• See each guide for apiVersion
• Prefer host ctx.safeFetch when required
• Do not write SQLite or own cron inside schedule plugins

Background

• Architecture
• Plugins overview
• Contributing docs