Contents

Module header
- Module header
Tooling expectations
- Tooling expectations
Spelling gate
- Spelling gate
CSS modules conventions
- CSS modules conventions
Package boundaries
- Package boundaries
Transport abstraction practice
- Transport abstraction practice
Command registry practice
- Command registry practice
Configuration format practice
- Configuration format practice
Configuration layering and reloadability practice
Visible-only WebGL rendering practice
- Visible-only WebGL rendering practice
WebGL context-loss recovery practice
- WebGL context-loss recovery practice
Pseudo-terminal (PTY) batching and frame-timing benchmark practice
- Pseudo-terminal (PTY) batching and frame-timing benchmark practice
Tab decoration provider practice
- Tab decoration provider practice
Context key and `when` practice
- Context key and `when` practice
esbuild build pipeline and safeguards
- esbuild build pipeline and safeguards
Electron runtime alignment
- Electron runtime alignment
GPU fallback launch switch
- GPU fallback launch switch
Chromium startup log noise suppression
- Chromium startup log noise suppression
React version alignment
- React version alignment
React component composition and translation patterns
- React component composition and translation patterns
Formatting and linting
- Formatting and linting
Vulnerability auditing practice
- Vulnerability auditing practice
Type checking
- Type checking
Tests
Default test gate

Visible-only WebGL rendering practice

Updated Jul 27, 2026

Roadmap item 2.1.1 introduces visible-only WebGL allocation. Follow these rules when changing terminal rendering behaviour:

Use the pane visibility model in lib/utils/pane-visibility.ts, which treats a pane as visible only when it is on the active tab, has non-zero bounds, and is not occluded.
Use lib/utils/webgl-context-pool.ts for WebGL allocation bookkeeping. Do not add ad hoc per-component context counters.
Keep renderer switching in lib/components/term.tsx and continue reporting renderer changes through Term.reportRenderer(...) so diagnostics and About dialog reporting stay consistent.
Respect the webGLRendererMaxContexts config value (default 16, positive integer). Runtime changes require active terminals to restart before the new pool size takes effect.