beatsaber-overlay/docs/ADR.md

Architectural Decision Record

Static web app with typed JavaScript

The overlay is plain HTML/CSS/JS with no bundler: run it locally with deno task serve or host the files on any static server. OBS uses an http(s) URL to the page.

Consequences: Ease of use

• Adding or updating the overlay is copy files or point OBS at a URL; nothing to build before use beyond optional Deno for local serving and the chat-request database path.
• Type safety is optional IDE assistance, not enforced at publish time (there is no tsc in CI by default).

This dependency-free client shape stays easy to wire as an OBS Browser Source while keeping the codebase maintainable through JSDoc and types.d.ts.

BeatSaberPlus

Because I already use it.