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

Module header

Updated Jul 27, 2026

Purpose: Summarize local development practices and validation commands for the Velocetty repository.
Invariants: Keep Makefile targets and validation steps aligned with Continuous Integration (CI) and tooling changes.
Cross-links: Testing with Bun, ADR 001, ADR 002, and Roadmap.

This guide captures the development practices specific to the Velocetty repository. It is intentionally concise and focused on the steps developers must follow locally.