Skip to main content
This is the entry point for working on the open Baryon repo — the web app and the shared visualization engine. It is source-available under the PolyForm Strict License 1.0.0, and contributions are welcome (a one-time CLA is required before your first pull request merges).

​
What lives in the public repo

The public repo is the web app plus the shared engine:
  • apps/web — the browser product shell deployed at app.baryon.live.
  • packages/engine — the engine: audio analysis, AudioFeatureFrame construction, the control schema, render-profile policy, and the raymarch runtime.
  • packages/app-shell — the shared React orchestration around the engine.
  • packages/config — shared build and test config.
  • docs/public — the pages on this site.
The desktop app is a separate commercial product and is not part of this repo. For how these pieces fit together, read the engine architecture.

​
Run it locally

Prerequisites: the Node version pinned in .nvmrc, pnpm, and Chrome or Edge for the WebGPU path.
Microphone input and SharedArrayBuffer need a secure context, so use the HTTPS dev server for that work:

​
Before you open a pull request

Run the fast verification gate — the same default checks CI runs — and fix any failures before pushing:
Branch from develop using a feature/, fix/, or docs/ prefix, and follow Conventional Commits (feat, fix, docs, refactor, test, chore) with a subject line under 72 characters.
New GUI controls must be added through the shared control schema and documented in the control panel reference. The schema is the single source of truth for keys, defaults, and live-vs-debug persistence.

​
Reference