Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.
Git Workflow for OpenScreen
Conventions for the Mavis reins when working in this repo.
Branches
- Default branch:
main. Never push to it directly. - Feature branches:
feature/<short-kebab>orfix/<short-kebab>. Match the style of recent merged PRs. - One PR = one concern. Don't bundle a refactor with a feature.
Commits
- Short imperative summary line (≤72 chars). Optional body explaining the why.
- Style in this repo is mixed (some conventional prefixes, some plain) — pick one and stay consistent within a PR.
- Husky pre-commit runs lint-staged (Biome on staged
*.{ts,tsx,js,jsx,mts,cts,json}). Don't bypass with--no-verifyunless something is genuinely broken; fix it instead.
Hooks (Mavis)
- Pre-commit (
.harness/hooks/pre-commit.md) — runs Biome + the affected unit test files. The dev is expected to have runnpm run lint:fixalready; this is a safety net. - Post-commit (
.harness/hooks/post-commit.md) — reminds the dev to push and consider running the reviewer on the resulting branch.
CI (.github/workflows/ci.yml)
CI runs on every PR to main, feat/ai-edition, release/** and integration/**, and on every push to those:
npm run lint(Biome)npx tsc --noEmit(TypeScript, app code)npx tsc -p tsconfig.test.json --noEmit(TypeScript, test files — a separate gate at zero)npm run test(Vitest unit)npm run docs:checknpx vite build(renderer build smoke)cargo test/cargo checkfor the compositor on macOS, Windows and Linuxswift testfor the capture core and a release build of both macOS helpers
All must be green before merge. The capture core has unit-test coverage, and both macOS helpers have compile coverage, but CI does not exercise real capture, permissions or devices. Manual smoke tests on the affected platforms are still required for native changes; note them in the PR description. See the CI job inventory for the exact checks and runners.
Pull request flow
- Branch from
main. - Implement + add tests in the same package.
- While implementing, run only the affected tests (
npx vitest --run <path>or--changed);npx tsc --noEmitandnpm run lintare the cheap inner-loop checks. Run the fullnpm run testonce, here, before pushing. - Push and open the PR via
gh pr create. Use.github/pull_request_template.md. - Wait for the Mavis reviewer (
openscreen-reviewer) PASS or address the requested changes. - Merge once CI is green and review is PASS. PR titles must follow Conventional Commits (enforced by the
semantic-prjob inci.yml) — this keeps the auto-generated release notes clean.
Release flow
Releases are cut by two workflow_dispatch workflows (prerelease.yml, then promote.yml). Trunk-based on main, but a release branch freezes the RC codebase between cut and promote.
The operational reference — workflow inputs, the release-branch contract, cherry-pick rules, the manual fallback, backports, milestone handling and the credentials — is technical-documentation/engineering/release-and-secrets.md. Read it before touching a release; do not restate it here, because the copy that lives outside the docs checker is the one that goes stale.