# acarlewis/keyblaze architecture

> Architecture diagram of the GitHub repository acarlewis/keyblaze, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/acarlewis/keyblaze
- Repository: https://github.com/acarlewis/keyblaze

## Overview

KeyBlaze is a VS Code typing-effects extension. A keystroke is detected, turned into a simulated burst, rendered as an editor decoration, and accompanied by optional combo, cursor, impact, and sound features. Settings and presets shape the experience; the Control Panel offers configuration and a live preview. The graph preserves documented capabilities, but some subsystem links are omitted where sampled source did not establish their runtime wiring.

Main entry points: [`src/extension.ts`](https://github.com/acarlewis/keyblaze/blob/main/src/extension.ts) (Extension Entry), [`src/services/EffectsController.ts`](https://github.com/acarlewis/keyblaze/blob/main/src/services/EffectsController.ts) (Effects Controller), [`src/services/SettingsService.ts`](https://github.com/acarlewis/keyblaze/blob/main/src/services/SettingsService.ts) (Settings Service), [`src/core/AnimationEngine.ts`](https://github.com/acarlewis/keyblaze/blob/main/src/core/AnimationEngine.ts) (Animation Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["VS Code Extension"]
  node_extension_entry["Extension Entry<br/>[extension.ts]"]
  node_typing_detector["Typing Detector<br/>[TypingDetector.ts]"]
  node_commands["Commands"]
end

subgraph group_effects["Typing Effects"]
  node_effects_controller["Effects Controller"]
  node_animation_engine["Animation Engine<br/>[AnimationEngine.ts]"]
  node_particle_engine["Particle Simulator<br/>[ParticleEngine.ts]"]
  node_effect_registry["Effect Registry<br/>[registry.ts]"]
  node_burst_track["Burst Track<br/>[BurstTrack.ts]"]
  node_svg_renderer["SVG Renderer<br/>[SvgRenderer.ts]"]
  node_decoration_renderer["Editor Decorations"]
end

subgraph group_experience["Editor Experience"]
  node_combo_service["Combo Service<br/>[ComboService.ts]"]
  node_combo_manager["Combo Manager<br/>[ComboManager.ts]"]
  node_combo_indicator["Combo Indicator<br/>[ComboIndicator.ts]"]
  node_environment["Motion and Focus Policy"]
  node_cursor_effects["Cursor Effects<br/>[CursorEffects.ts]"]
  node_impact_pulse["Impact Pulse<br/>[ImpactPulse.ts]"]
  node_sound_service["Sound Service<br/>[SoundService.ts]"]
end

subgraph group_settings["Settings and Views"]
  node_settings_service["Settings Service<br/>[SettingsService.ts]"]
  node_schema["Settings Schema<br/>[schema.ts]"]
  node_presets["Preset Definitions<br/>[presets.ts]"]
  node_control_panel["Control Panel Provider"]
  node_panel_webview["Control Panel UI<br/>[controlPanel.ts]"]
  node_preview["Live Preview<br/>[preview.ts]"]
  node_sound_view["Sound View Provider"]
end

node_developer(("Developer"))

node_developer -->|"types in"| node_extension_entry
node_extension_entry -->|"starts"| node_typing_detector
node_extension_entry -->|"starts"| node_effects_controller
node_extension_entry -->|"starts"| node_combo_service
node_extension_entry -->|"starts"| node_settings_service
node_extension_entry -->|"starts"| node_environment
node_extension_entry -->|"starts"| node_cursor_effects
node_extension_entry -->|"starts"| node_impact_pulse
node_extension_entry -->|"starts"| node_sound_service
node_extension_entry -->|"registers"| node_commands
node_typing_detector -->|"notifies"| node_effects_controller
node_typing_detector -->|"notifies"| node_combo_service
node_effects_controller -->|"reads"| node_settings_service
node_effects_controller -->|"simulates with"| node_animation_engine
node_animation_engine -->|"selects"| node_effect_registry
node_animation_engine -->|"simulates via"| node_particle_engine
node_animation_engine -->|"produces"| node_burst_track
node_effects_controller -->|"renders"| node_svg_renderer
node_effects_controller -->|"places"| node_decoration_renderer
node_combo_service -->|"tracks with"| node_combo_manager
node_combo_service -->|"reads"| node_settings_service
node_control_panel -->|"updates"| node_settings_service
node_control_panel -->|"validates with"| node_schema
node_settings_service -->|"resolves via"| node_schema
node_settings_service -->|"applies"| node_presets
node_panel_webview -->|"creates"| node_preview
node_preview -->|"simulates with"| node_animation_engine
node_preview -->|"tracks with"| node_combo_manager
node_extension_entry -->|"starts"| node_combo_indicator
node_extension_entry -->|"starts"| node_sound_view

click node_extension_entry "https://github.com/acarlewis/keyblaze/blob/main/src/extension.ts"
click node_typing_detector "https://github.com/acarlewis/keyblaze/blob/main/src/services/TypingDetector.ts"
click node_settings_service "https://github.com/acarlewis/keyblaze/blob/main/src/services/SettingsService.ts"
click node_schema "https://github.com/acarlewis/keyblaze/blob/main/src/config/schema.ts"
click node_presets "https://github.com/acarlewis/keyblaze/blob/main/src/config/presets.ts"
click node_effects_controller "https://github.com/acarlewis/keyblaze/blob/main/src/services/EffectsController.ts"
click node_animation_engine "https://github.com/acarlewis/keyblaze/blob/main/src/core/AnimationEngine.ts"
click node_particle_engine "https://github.com/acarlewis/keyblaze/blob/main/src/core/ParticleEngine.ts"
click node_effect_registry "https://github.com/acarlewis/keyblaze/blob/main/src/effects/registry.ts"
click node_burst_track "https://github.com/acarlewis/keyblaze/blob/main/src/core/BurstTrack.ts"
click node_svg_renderer "https://github.com/acarlewis/keyblaze/blob/main/src/render/SvgRenderer.ts"
click node_decoration_renderer "https://github.com/acarlewis/keyblaze/blob/main/src/services/DecorationRenderer.ts"
click node_combo_service "https://github.com/acarlewis/keyblaze/blob/main/src/services/ComboService.ts"
click node_combo_manager "https://github.com/acarlewis/keyblaze/blob/main/src/core/ComboManager.ts"
click node_combo_indicator "https://github.com/acarlewis/keyblaze/blob/main/src/services/ComboIndicator.ts"
click node_environment "https://github.com/acarlewis/keyblaze/blob/main/src/services/EnvironmentService.ts"
click node_cursor_effects "https://github.com/acarlewis/keyblaze/blob/main/src/services/CursorEffects.ts"
click node_impact_pulse "https://github.com/acarlewis/keyblaze/blob/main/src/services/ImpactPulse.ts"
click node_sound_service "https://github.com/acarlewis/keyblaze/blob/main/src/services/SoundService.ts"
click node_control_panel "https://github.com/acarlewis/keyblaze/blob/main/src/providers/ControlPanelProvider.ts"
click node_panel_webview "https://github.com/acarlewis/keyblaze/blob/main/src/webview/controlPanel.ts"
click node_preview "https://github.com/acarlewis/keyblaze/blob/main/src/webview/preview.ts"
click node_sound_view "https://github.com/acarlewis/keyblaze/blob/main/src/providers/SoundViewProvider.ts"
click node_commands "https://github.com/acarlewis/keyblaze/blob/main/src/commands/registerCommands.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_extension_entry,node_typing_detector,node_commands toneBlue
class node_effects_controller,node_animation_engine,node_particle_engine,node_effect_registry,node_burst_track,node_svg_renderer,node_decoration_renderer toneAmber
class node_combo_service,node_combo_manager,node_combo_indicator,node_environment,node_cursor_effects,node_impact_pulse,node_sound_service toneMint
class node_settings_service,node_schema,node_presets,node_control_panel,node_panel_webview,node_preview,node_sound_view toneRose
class node_developer toneIndigo
```

## Components

### VS Code Extension

- [Extension Entry](https://github.com/acarlewis/keyblaze/blob/main/src/extension.ts): `src/extension.ts`
- [Typing Detector](https://github.com/acarlewis/keyblaze/blob/main/src/services/TypingDetector.ts): `src/services/TypingDetector.ts`
- [Commands](https://github.com/acarlewis/keyblaze/blob/main/src/commands/registerCommands.ts): `src/commands/registerCommands.ts`

### Typing Effects

- [Effects Controller](https://github.com/acarlewis/keyblaze/blob/main/src/services/EffectsController.ts): `src/services/EffectsController.ts`
- [Animation Engine](https://github.com/acarlewis/keyblaze/blob/main/src/core/AnimationEngine.ts): `src/core/AnimationEngine.ts`
- [Particle Simulator](https://github.com/acarlewis/keyblaze/blob/main/src/core/ParticleEngine.ts): `src/core/ParticleEngine.ts`
- [Effect Registry](https://github.com/acarlewis/keyblaze/blob/main/src/effects/registry.ts): `src/effects/registry.ts`
- [Burst Track](https://github.com/acarlewis/keyblaze/blob/main/src/core/BurstTrack.ts): `src/core/BurstTrack.ts`
- [SVG Renderer](https://github.com/acarlewis/keyblaze/blob/main/src/render/SvgRenderer.ts): `src/render/SvgRenderer.ts`
- [Editor Decorations](https://github.com/acarlewis/keyblaze/blob/main/src/services/DecorationRenderer.ts): `src/services/DecorationRenderer.ts`

### Editor Experience

- [Combo Service](https://github.com/acarlewis/keyblaze/blob/main/src/services/ComboService.ts): `src/services/ComboService.ts`
- [Combo Manager](https://github.com/acarlewis/keyblaze/blob/main/src/core/ComboManager.ts): `src/core/ComboManager.ts`
- [Combo Indicator](https://github.com/acarlewis/keyblaze/blob/main/src/services/ComboIndicator.ts): `src/services/ComboIndicator.ts`
- [Motion and Focus Policy](https://github.com/acarlewis/keyblaze/blob/main/src/services/EnvironmentService.ts): `src/services/EnvironmentService.ts`
- [Cursor Effects](https://github.com/acarlewis/keyblaze/blob/main/src/services/CursorEffects.ts): `src/services/CursorEffects.ts`
- [Impact Pulse](https://github.com/acarlewis/keyblaze/blob/main/src/services/ImpactPulse.ts): `src/services/ImpactPulse.ts`
- [Sound Service](https://github.com/acarlewis/keyblaze/blob/main/src/services/SoundService.ts): `src/services/SoundService.ts`

### Settings and Views

- [Settings Service](https://github.com/acarlewis/keyblaze/blob/main/src/services/SettingsService.ts): `src/services/SettingsService.ts`
- [Settings Schema](https://github.com/acarlewis/keyblaze/blob/main/src/config/schema.ts): `src/config/schema.ts`
- [Preset Definitions](https://github.com/acarlewis/keyblaze/blob/main/src/config/presets.ts): `src/config/presets.ts`
- [Control Panel Provider](https://github.com/acarlewis/keyblaze/blob/main/src/providers/ControlPanelProvider.ts): `src/providers/ControlPanelProvider.ts`
- [Control Panel UI](https://github.com/acarlewis/keyblaze/blob/main/src/webview/controlPanel.ts): `src/webview/controlPanel.ts`
- [Live Preview](https://github.com/acarlewis/keyblaze/blob/main/src/webview/preview.ts): `src/webview/preview.ts`
- [Sound View Provider](https://github.com/acarlewis/keyblaze/blob/main/src/providers/SoundViewProvider.ts): `src/providers/SoundViewProvider.ts`

### Other components

- **Developer**

## Connections

- Developer → Extension Entry: types in (evidence: `README.md`)
- Extension Entry → Typing Detector: starts (evidence: `src/extension.ts`)
- Extension Entry → Effects Controller: starts (evidence: `src/extension.ts`)
- Extension Entry → Combo Service: starts (evidence: `src/extension.ts`)
- Extension Entry → Settings Service: starts (evidence: `src/extension.ts`)
- Extension Entry → Motion and Focus Policy: starts (evidence: `src/extension.ts`)
- Extension Entry → Cursor Effects: starts (evidence: `src/extension.ts`)
- Extension Entry → Impact Pulse: starts (evidence: `src/extension.ts`)
- Extension Entry → Sound Service: starts (evidence: `src/extension.ts`)
- Extension Entry → Commands: registers (evidence: `src/extension.ts`)
- Typing Detector → Effects Controller: notifies (evidence: `src/services/EffectsController.ts`)
- Typing Detector → Combo Service: notifies (evidence: `src/services/ComboService.ts`)
- Effects Controller → Settings Service: reads (evidence: `src/services/EffectsController.ts`)
- Effects Controller → Animation Engine: simulates with (evidence: `src/services/EffectsController.ts`)
- Animation Engine → Effect Registry: selects (evidence: `src/core/AnimationEngine.ts`)
- Animation Engine → Particle Simulator: simulates via (evidence: `src/core/AnimationEngine.ts`)
- Animation Engine → Burst Track: produces (evidence: `src/core/AnimationEngine.ts`)
- Effects Controller → SVG Renderer: renders (evidence: `src/services/EffectsController.ts`)
- Effects Controller → Editor Decorations: places (evidence: `src/services/EffectsController.ts`)
- Combo Service → Combo Manager: tracks with (evidence: `src/services/ComboService.ts`)
- Combo Service → Settings Service: reads (evidence: `src/services/ComboService.ts`)
- Control Panel Provider → Settings Service: updates (evidence: `src/providers/ControlPanelProvider.ts`)
- Control Panel Provider → Settings Schema: validates with (evidence: `src/providers/ControlPanelProvider.ts`)
- Settings Service → Settings Schema: resolves via (evidence: `src/services/SettingsService.ts`)
- Settings Service → Preset Definitions: applies (evidence: `src/services/SettingsService.ts`)
- Control Panel UI → Live Preview: creates (evidence: `src/webview/controlPanel.ts`)
- Live Preview → Animation Engine: simulates with (evidence: `src/webview/preview.ts`)
- Live Preview → Combo Manager: tracks with (evidence: `src/webview/preview.ts`)
- Extension Entry → Combo Indicator: starts (evidence: `src/extension.ts`)
- Extension Entry → Sound View Provider: starts (evidence: `src/extension.ts`)
