# wieslawsoltes/winxp architecture

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

- Interactive diagram: https://gitdiagram.com/wieslawsoltes/winxp
- Repository: https://github.com/wieslawsoltes/winxp

## Overview

XP Desktop is a browser-based Windows XP-style workspace. A user interacts with the desktop and launches registered applications; those applications provide document, image, game, internet/media, accessibility, and system-tool workflows. The shell manages windows and Explorer, while the core provides virtual-file and settings storage, and the renderer draws the wallpaper. Relationships below are limited to capabilities and architecture explicitly described in the README; implementation excerpts were not provided, so source-level call wiring cannot be verified.

Main entry points: [`dist/packages/shell/main.js`](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/main.js) (Desktop and startup), [`dist/packages/core/index.js`](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/core/index.js) (Virtual filesystem), [`dist/packages/shell/explorer.js`](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/explorer.js) (Explorer and files), [`dist/packages/apps-editors`](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-editors) (Documents and editors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_desktop["Desktop and startup<br/>[main.js]"]
  node_windows["Window manager<br/>[window-manager.js]"]
  node_explorer["Explorer and files<br/>[explorer.js]"]
  node_dialogs["Dialogs<br/>[dialogs.js]"]
  node_runtime["Runtime services"]
end

subgraph group_platform["Runtime platform"]
  node_core[("Virtual filesystem<br/>[index.js]")]
  node_sdk["UI components<br/>[index.js]"]
  node_renderer["Wallpaper renderer<br/>[index.js]"]
end

subgraph group_work["Productivity apps"]
  node_editors["Documents and editors"]
  node_graphics["Paint and images"]
end

subgraph group_media["Media and games"]
  node_browser["Browser and internet"]
  node_mediaapps["Audio and video"]
  node_games["Games"]
  node_pinball["Pinball"]
end

subgraph group_tools["System tools"]
  node_accessibility["Accessibility"]
  node_system["System utilities"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_desktop
node_desktop -->|"manages windows"| node_windows
node_desktop -->|"launches Explorer"| node_explorer
node_desktop -->|"starts runtime"| node_runtime
node_explorer -->|"browses files"| node_core
node_explorer -->|"uses file dialogs"| node_dialogs
node_editors -->|"stores documents"| node_core
node_graphics -->|"saves images"| node_core
node_browser -->|"uses virtual files"| node_core
node_mediaapps -->|"uses virtual files"| node_core
node_runtime -->|"provides storage"| node_core
node_desktop -->|"renders wallpaper"| node_renderer
node_desktop -->|"launches apps"| node_editors
node_desktop -->|"launches apps"| node_graphics
node_desktop -->|"launches apps"| node_browser
node_desktop -->|"launches apps"| node_mediaapps
node_desktop -->|"launches apps"| node_games
node_desktop -->|"launches app"| node_pinball
node_desktop -->|"launches apps"| node_accessibility
node_desktop -->|"launches apps"| node_system
node_editors -.->|"uses UI components"| node_sdk
node_games -.->|"uses UI components"| node_sdk

click node_desktop "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/main.js"
click node_windows "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/window-manager.js"
click node_explorer "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/explorer.js"
click node_dialogs "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/dialogs.js"
click node_runtime "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/runtime-services.js"
click node_core "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/core/index.js"
click node_sdk "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/sdk/index.js"
click node_renderer "https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/renderer/index.js"
click node_editors "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-editors"
click node_graphics "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-graphics"
click node_browser "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-internet"
click node_mediaapps "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-internet"
click node_games "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-games"
click node_pinball "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-pinball"
click node_accessibility "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-accessibility"
click node_system "https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-system"

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_desktop,node_windows,node_explorer,node_dialogs,node_runtime,node_user toneBlue
class node_core,node_sdk,node_renderer toneAmber
class node_editors,node_graphics toneMint
class node_browser,node_mediaapps,node_games,node_pinball toneRose
class node_accessibility,node_system toneIndigo
```

## Components

### Desktop shell

- [Desktop and startup](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/main.js): `dist/packages/shell/main.js`
- [Window manager](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/window-manager.js): `dist/packages/shell/window-manager.js`
- [Explorer and files](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/explorer.js): `dist/packages/shell/explorer.js`
- [Dialogs](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/dialogs.js): `dist/packages/shell/dialogs.js`
- [Runtime services](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/shell/runtime-services.js): `dist/packages/shell/runtime-services.js`

### Runtime platform

- [Virtual filesystem](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/core/index.js): `dist/packages/core/index.js`
- [UI components](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/sdk/index.js): `dist/packages/sdk/index.js`
- [Wallpaper renderer](https://github.com/wieslawsoltes/winxp/blob/main/dist/packages/renderer/index.js): `dist/packages/renderer/index.js`

### Productivity apps

- [Documents and editors](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-editors): `dist/packages/apps-editors`
- [Paint and images](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-graphics): `dist/packages/apps-graphics`

### Media and games

- [Browser and internet](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-internet): `dist/packages/apps-internet`
- [Audio and video](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-internet): `dist/packages/apps-internet`
- [Games](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-games): `dist/packages/apps-games`
- [Pinball](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-pinball): `dist/packages/apps-pinball`

### System tools

- [Accessibility](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-accessibility): `dist/packages/apps-accessibility`
- [System utilities](https://github.com/wieslawsoltes/winxp/tree/main/dist/packages/apps-system): `dist/packages/apps-system`

### Other components

- **Desktop user**

## Connections

- Desktop user → Desktop and startup: uses (evidence: `README.md`)
- Desktop and startup → Window manager: manages windows (evidence: `README.md`)
- Desktop and startup → Explorer and files: launches Explorer (evidence: `README.md`)
- Desktop and startup → Runtime services: starts runtime (evidence: `README.md`)
- Explorer and files → Virtual filesystem: browses files (evidence: `README.md`)
- Explorer and files → Dialogs: uses file dialogs (evidence: `README.md`)
- Documents and editors → Virtual filesystem: stores documents (evidence: `README.md`)
- Paint and images → Virtual filesystem: saves images (evidence: `README.md`)
- Browser and internet → Virtual filesystem: uses virtual files (evidence: `README.md`)
- Audio and video → Virtual filesystem: uses virtual files (evidence: `README.md`)
- Runtime services → Virtual filesystem: provides storage (evidence: `README.md`)
- Desktop and startup → Wallpaper renderer: renders wallpaper (evidence: `README.md`)
- Desktop and startup → Documents and editors: launches apps (evidence: `README.md`)
- Desktop and startup → Paint and images: launches apps (evidence: `README.md`)
- Desktop and startup → Browser and internet: launches apps (evidence: `README.md`)
- Desktop and startup → Audio and video: launches apps (evidence: `README.md`)
- Desktop and startup → Games: launches apps (evidence: `README.md`)
- Desktop and startup → Pinball: launches app (evidence: `README.md`)
- Desktop and startup → Accessibility: launches apps (evidence: `README.md`)
- Desktop and startup → System utilities: launches apps (evidence: `README.md`)
- Documents and editors → UI components: uses UI components
- Games → UI components: uses UI components
