Describe the problem and the affected device, browser or platform. Follow the code of conduct. Keep tokens, private invite links and other people's video out of issues, pull requests and commits.
Install Node.js 24 and pnpm, then run:
pnpm install --frozen-lockfile
pnpm format
pnpm check
pnpm test
pnpm buildcheck runs Biome, Oxc's tsrs type checker and Knip. check:all also runs native Rust checks and
requires the native prerequisites below. The lockfile retains the configured
three-day minimum release age; update dependencies with pnpm update --latest
and review the manifest and lockfile together.
The camera UI uses shadcn/ui with Base UI and Tailwind CSS. Components live in
src/components/ui and theme tokens live in src/theme.css. Use
pnpm exec shadcn add <component> --dry-run to review generated changes before applying them.
Install Rust 1.92+. Linux builds need GLib/libclang headers and clang 21 or newer:
sudo apt-get install libglib2.0-dev libclang-21-dev clang-21If your distribution does not provide clang 21, use LLVM's
official package repository. Recording tests also need
the ffmpeg command with libx264 available.
cargo install cargo-machete --version 0.9.2 --locked
cargo install cargo-deny --version 0.20.2 --locked
cargo machete --with-metadata --skip-target-dir
cargo deny --manifest-path native/cameras/Cargo.toml --config native/cameras/deny.toml --all-features --exclude-dev --locked check bans
cargo deny --manifest-path native/invite/Cargo.toml --config native/invite/deny.toml --all-features --exclude-dev --locked check bans
cargo fmt
CXX=clang++-21 cargo clippy --workspace --all-targets --all-features -- -D warnings
CXX=clang++-21 cargo test --workspaceCXX applies to Linux; use the platform compiler elsewhere. On Windows, set
RUSTFLAGS=-C target-feature=+crt-static to match LiveKit's WebRTC library.
CI builds and runs non-hardware tests on Linux, macOS and Windows. Report which
real devices and rooms you tested; CI does not validate hardware encoders or
physical cameras.
Run cargo upgrade --dry-run --incompatible --pinned to review newer releases.
Update the LiveKit SDK and signaling dependency together, and verify capture
backend changes on the OS matrix. Keep linker and sccache choices machine-local
so contributors and portable builds can use their platform defaults.
Native source, Cargo configuration, lockfiles and workflow changes run the Rust matrix on all three operating systems. Browser inputs run lint, tests and a build that includes typechecking. Documentation-only pull requests run link checks and Biome without compiling Rust or building the browser app. Every main-branch push runs browser validation and prepares a Pages deployment, including pushes that only change documentation or native code. This ensures a newer push replaces any older browser deployment it supersedes. Manual workflow runs always run every check.
Rust dependency artifacts are cached by platform, compiler/toolchain settings, Cargo manifests and lockfile. Compiler variables are set before restoring the cache, including Windows' static runtime flag. The browser job caches pnpm's store. Only main-branch Rust jobs save caches; pull requests can restore them. A cold run still compiles dependencies, and cached runs still execute tests and build the native executables. Superseded pull-request runs are cancelled. Main runs finish independently so a later documentation-only push cannot cancel an outstanding Rust check. Pages deployment verifies the latest main revision.
Use descriptive names, explicit types and exhaustive variants where practical. Test observable outcomes; avoid tests that only repeat third-party behavior. Keep camera naming, freshness policy and credentials in the consuming application.
Follow the Google developer documentation style guide. Keep setup instructions task-focused, use sentence-case headings and descriptive links, and link to official upstream references for general SDK behavior. Keep this project's defaults, contracts and limitations documented here.
Check local links with lychee --offline --include-fragments=anchor-only README.md CONTRIBUTING.md docs/*.md native/*/README.md; use lychee without --offline
when validating external references. It checks links, not spelling.
Squash fixup commits before merging when useful. Preserve published revisions that consumers pin. Contributions use the MIT license.