# ecksdy/vscode-env-switcher architecture

> Architecture diagram of the GitHub repository ecksdy/vscode-env-switcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ecksdy/vscode-env-switcher
- Repository: https://github.com/ecksdy/vscode-env-switcher

## Overview

This is a VS Code extension for selecting a workspace .env preset and overwriting a target file, with the selected preset shown in the status bar. Users switch through the status-bar UI or the preset command; the extension routes selection through workspace-scoped preset management, persists the choice, and copies preset contents to the target. A webview offers a workspace/preset interface. The README documents configurable file matching and warnings for risky preset names. Relationships reflect excerpts and README statements; some UI wiring and status-bar implementation details were not sampled.

Main entry points: [`src/managers/fs-preset-manager.ts`](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/managers/fs-preset-manager.ts) (Preset manager), [`src/utilities/workspace.ts`](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/utilities/workspace.ts) (Workspace facade), [`src/ui-components/presets-view-provider.ts`](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/ui-components/presets-view-provider.ts) (Presets view provider), [`src/command-implementations/select-env-preset.ts`](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/command-implementations/select-env-preset.ts) (Preset command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Extension entry"]
  node_extension["Activation<br/>[extension.ts]"]
  node_statusbar["Status bar"]
end

subgraph group_selection["Preset selection"]
  node_command["Preset command"]
end

subgraph group_runtime["Workspace runtime"]
  node_workspace["Workspace facade<br/>[workspace.ts]"]
  node_manager["Preset manager"]
  node_watcher["File watcher<br/>[file-watcher.ts]"]
  node_persister[("Selection persistence")]
  node_config["Extension settings<br/>[config.ts]"]
  node_fshelper["File operations<br/>[fs-helper.ts]"]
end

subgraph group_webview["Webview UI"]
  node_provider["Presets view provider"]
  node_app["Webview app<br/>[App.svelte]"]
  node_panel["Preset panel<br/>[PanelComp.svelte]"]
  node_vscodebridge["VS Code bridge<br/>[vscode.ts]"]
end

node_user(("VS Code user"))
node_target["Target .env file"]
node_presetfiles["Preset files"]

node_user -->|"switches preset"| node_statusbar
node_user -->|"runs command"| node_command
node_extension -->|"creates"| node_statusbar
node_extension -->|"registers"| node_command
node_extension -->|"registers"| node_provider
node_command -->|"gets presets"| node_workspace
node_command -->|"emits selection"| node_workspace
node_workspace -->|"delegates"| node_manager
node_workspace -->|"builds"| node_watcher
node_workspace -->|"resolves"| node_persister
node_manager -->|"stores selection"| node_persister
node_manager -->|"watches preset"| node_watcher
node_manager -->|"reads and writes"| node_fshelper
node_manager -->|"uses file globs"| node_config
node_manager -->|"discovers and reads"| node_presetfiles
node_manager -->|"overwrites contents"| node_target
node_provider -->|"loads workspace presets"| node_workspace
node_provider -->|"serves webview"| node_app
node_app -->|"renders"| node_panel
node_panel -->|"uses messaging"| node_vscodebridge
node_provider -.->|"presents preset choices"| node_user

click node_extension "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/extension.ts"
click node_statusbar "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/ui-components/env-status-bar-item.ts"
click node_command "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/command-implementations/select-env-preset.ts"
click node_workspace "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/utilities/workspace.ts"
click node_manager "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/managers/fs-preset-manager.ts"
click node_watcher "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/watchers/file-watcher.ts"
click node_persister "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/managers/memento-persister.ts"
click node_config "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/utilities/config.ts"
click node_fshelper "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/utilities/fs-helper.ts"
click node_provider "https://github.com/ecksdy/vscode-env-switcher/blob/master/src/ui-components/presets-view-provider.ts"
click node_app "https://github.com/ecksdy/vscode-env-switcher/blob/master/webview-ui/src/App.svelte"
click node_panel "https://github.com/ecksdy/vscode-env-switcher/blob/master/webview-ui/src/PanelComp.svelte"
click node_vscodebridge "https://github.com/ecksdy/vscode-env-switcher/blob/master/webview-ui/src/utilities/vscode.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,node_statusbar,node_user toneBlue
class node_command toneAmber
class node_workspace,node_manager,node_watcher,node_persister,node_config,node_fshelper toneMint
class node_provider,node_app,node_panel,node_vscodebridge toneRose
class node_target,node_presetfiles toneIndigo
```

## Components

### Extension entry

- [Activation](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/extension.ts): `src/extension.ts`
- [Status bar](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/ui-components/env-status-bar-item.ts): `src/ui-components/env-status-bar-item.ts`

### Preset selection

- [Preset command](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/command-implementations/select-env-preset.ts): `src/command-implementations/select-env-preset.ts`

### Workspace runtime

- [Workspace facade](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/utilities/workspace.ts): `src/utilities/workspace.ts`
- [Preset manager](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/managers/fs-preset-manager.ts): `src/managers/fs-preset-manager.ts`
- [File watcher](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/watchers/file-watcher.ts): `src/watchers/file-watcher.ts`
- [Selection persistence](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/managers/memento-persister.ts): `src/managers/memento-persister.ts`
- [Extension settings](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/utilities/config.ts): `src/utilities/config.ts`
- [File operations](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/utilities/fs-helper.ts): `src/utilities/fs-helper.ts`

### Webview UI

- [Presets view provider](https://github.com/ecksdy/vscode-env-switcher/blob/master/src/ui-components/presets-view-provider.ts): `src/ui-components/presets-view-provider.ts`
- [Webview app](https://github.com/ecksdy/vscode-env-switcher/blob/master/webview-ui/src/App.svelte): `webview-ui/src/App.svelte`
- [Preset panel](https://github.com/ecksdy/vscode-env-switcher/blob/master/webview-ui/src/PanelComp.svelte): `webview-ui/src/PanelComp.svelte`
- [VS Code bridge](https://github.com/ecksdy/vscode-env-switcher/blob/master/webview-ui/src/utilities/vscode.ts): `webview-ui/src/utilities/vscode.ts`

### Other components

- **VS Code user**
- **Target .env file**
- **Preset files**

## Connections

- VS Code user → Status bar: switches preset
- VS Code user → Preset command: runs command
- Activation → Status bar: creates (evidence: `src/extension.ts`)
- Activation → Preset command: registers (evidence: `src/extension.ts`)
- Activation → Presets view provider: registers (evidence: `src/extension.ts`)
- Preset command → Workspace facade: gets presets (evidence: `src/command-implementations/select-env-preset.ts`)
- Preset command → Workspace facade: emits selection (evidence: `src/command-implementations/select-env-preset.ts`)
- Workspace facade → Preset manager: delegates (evidence: `src/utilities/workspace.ts`)
- Workspace facade → File watcher: builds (evidence: `src/utilities/workspace.ts`)
- Workspace facade → Selection persistence: resolves (evidence: `src/utilities/workspace.ts`)
- Preset manager → Selection persistence: stores selection (evidence: `src/managers/fs-preset-manager.ts`)
- Preset manager → File watcher: watches preset (evidence: `src/managers/fs-preset-manager.ts`)
- Preset manager → File operations: reads and writes (evidence: `src/managers/fs-preset-manager.ts`)
- Preset manager → Extension settings: uses file globs (evidence: `src/managers/fs-preset-manager.ts`)
- Preset manager → Preset files: discovers and reads (evidence: `src/managers/fs-preset-manager.ts`)
- Preset manager → Target .env file: overwrites contents (evidence: `src/managers/fs-preset-manager.ts`)
- Presets view provider → Workspace facade: loads workspace presets (evidence: `src/ui-components/presets-view-provider.ts`)
- Presets view provider → Webview app: serves webview (evidence: `src/ui-components/presets-view-provider.ts`)
- Webview app → Preset panel: renders (evidence: `webview-ui/src/App.svelte`)
- Preset panel → VS Code bridge: uses messaging (evidence: `webview-ui/src/PanelComp.svelte`)
- Presets view provider → VS Code user: presents preset choices
