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

Configuration format practice

Updated Jul 27, 2026

Roadmap item 1.3.1 moves repository config handling to JSON5-only semantics for active configuration files:

Parse and write config.json5 as JSON5 (including comments and trailing commas).
Do not rely on .hyper.js migration; legacy migration paths were removed.
Persist runtime plugin settings under config.plugins.<plugin-id> in config.json5.
Keep config-validation diagnostics structured with required fields: path, message, and suggestedFix (optional docHint and defaultHint may be included when available).
Preserve user-authored comments and formatting when roundtripping config.json5; avoid full-file canonical rewrites for targeted runtime settings updates.