ide/architecture.md

Architecture

Git.Zone IDE is split into a local Electron shell and a remote Theia workspace server.

Local Electron Shell

The Electron app is intentionally small. It owns SSH host selection, remote bootstrap execution, local SSH tunnel lifecycle, and workspace windows. It does not implement remote filesystem, terminal, or Git behavior itself.

Remote Theia Server

The remote server is a Theia browser application installed under ~/.git.zone/ide-server/<version>. It runs on the SSH host, bound to 127.0.0.1, and is accessed only through an SSH local port forward.

Execution Boundary

Files, terminal commands, Git, language servers, builds, tests, and Git.Zone commands all run on the remote SSH host. The local machine displays UI and maintains SSH transport.