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

Tooling expectations

Updated Jul 27, 2026

Use Bun for JavaScript and TypeScript scripts.
Prefer Makefile targets for validation commands.
Use tsgo (@typescript/native-preview) for TypeScript compilation and type-checking tasks.
Use build/esbuild/build.ts as the canonical JavaScript bundling entrypoint for renderer, CLI, and app copy artefacts.
Keep documentation wrapped to 80 columns and code blocks to 120 columns.