# erriswheel/eve architecture

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

- Interactive diagram: https://gitdiagram.com/erriswheel/eve
- Repository: https://github.com/erriswheel/eve

## Overview

EVE is described as an “Expandable Voice Engine,” but the sampled repository shows an early desktop scaffold rather than a working voice or AI workflow. The visible runtime mounts a React starter UI inside Electron; Electron also sends a startup message that the renderer logs. Shared packages define message types, event names, constants, and basic configuration/environment access, but no sampled code connects them to the desktop runtime. The graph reflects only these demonstrated capabilities; the README gives no further product detail.

Main entry points: [`apps/desktop/electron/main.ts`](https://github.com/erriswheel/eve/blob/main/apps/desktop/electron/main.ts) (Electron main), [`apps/desktop/src/main.tsx`](https://github.com/erriswheel/eve/blob/main/apps/desktop/src/main.tsx) (Renderer bootstrap), [`apps/desktop/src/App.tsx`](https://github.com/erriswheel/eve/blob/main/apps/desktop/src/App.tsx) (Starter UI), [`apps/desktop/electron/preload.ts`](https://github.com/erriswheel/eve/blob/main/apps/desktop/electron/preload.ts) (Preload bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_renderer["Renderer bootstrap<br/>[main.tsx]"]
  node_ui["Starter UI<br/>[App.tsx]"]
  node_electron["Electron main<br/>[main.ts]"]
  node_preload["Preload bridge<br/>[preload.ts]"]
end

subgraph group_shared["Shared contracts"]
  node_shared_types["Message types<br/>[types.ts]"]
  node_shared_events["Event names<br/>[events.ts]"]
  node_shared_constants["App constants<br/>[constants.ts]"]
end

subgraph group_configuration["Configuration"]
  node_app_config["App configuration<br/>[Config.ts]"]
  node_env_config["Environment access<br/>[Env.ts]"]
end

node_user(("Desktop user"))

node_user -->|"interacts with"| node_ui
node_renderer -->|"mounts"| node_ui
node_electron -->|"loads"| node_renderer
node_electron -->|"configures"| node_preload
node_electron -->|"sends startup message"| node_renderer
node_renderer -->|"logs startup message"| node_electron

click node_renderer "https://github.com/erriswheel/eve/blob/main/apps/desktop/src/main.tsx"
click node_ui "https://github.com/erriswheel/eve/blob/main/apps/desktop/src/App.tsx"
click node_electron "https://github.com/erriswheel/eve/blob/main/apps/desktop/electron/main.ts"
click node_preload "https://github.com/erriswheel/eve/blob/main/apps/desktop/electron/preload.ts"
click node_shared_types "https://github.com/erriswheel/eve/blob/main/packages/shared/src/types.ts"
click node_shared_events "https://github.com/erriswheel/eve/blob/main/packages/shared/src/events.ts"
click node_shared_constants "https://github.com/erriswheel/eve/blob/main/packages/shared/src/constants.ts"
click node_app_config "https://github.com/erriswheel/eve/blob/main/packages/config/src/Config.ts"
click node_env_config "https://github.com/erriswheel/eve/blob/main/packages/config/src/Env.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_renderer,node_ui,node_electron,node_preload,node_user toneBlue
class node_shared_types,node_shared_events,node_shared_constants toneAmber
class node_app_config,node_env_config toneMint
```

## Components

### Desktop shell

- [Renderer bootstrap](https://github.com/erriswheel/eve/blob/main/apps/desktop/src/main.tsx): `apps/desktop/src/main.tsx`
- [Starter UI](https://github.com/erriswheel/eve/blob/main/apps/desktop/src/App.tsx): `apps/desktop/src/App.tsx`
- [Electron main](https://github.com/erriswheel/eve/blob/main/apps/desktop/electron/main.ts): `apps/desktop/electron/main.ts`
- [Preload bridge](https://github.com/erriswheel/eve/blob/main/apps/desktop/electron/preload.ts): `apps/desktop/electron/preload.ts`

### Shared contracts

- [Message types](https://github.com/erriswheel/eve/blob/main/packages/shared/src/types.ts): `packages/shared/src/types.ts`
- [Event names](https://github.com/erriswheel/eve/blob/main/packages/shared/src/events.ts): `packages/shared/src/events.ts`
- [App constants](https://github.com/erriswheel/eve/blob/main/packages/shared/src/constants.ts): `packages/shared/src/constants.ts`

### Configuration

- [App configuration](https://github.com/erriswheel/eve/blob/main/packages/config/src/Config.ts): `packages/config/src/Config.ts`
- [Environment access](https://github.com/erriswheel/eve/blob/main/packages/config/src/Env.ts): `packages/config/src/Env.ts`

### Other components

- **Desktop user**

## Connections

- Desktop user → Starter UI: interacts with (evidence: `apps/desktop/src/App.tsx`)
- Renderer bootstrap → Starter UI: mounts (evidence: `apps/desktop/src/main.tsx`)
- Electron main → Renderer bootstrap: loads (evidence: `apps/desktop/electron/main.ts`)
- Electron main → Preload bridge: configures (evidence: `apps/desktop/electron/main.ts`)
- Electron main → Renderer bootstrap: sends startup message (evidence: `apps/desktop/electron/main.ts`)
- Renderer bootstrap → Electron main: logs startup message (evidence: `apps/desktop/src/main.tsx`)
