Skip to content

Development ​

Welcome to ZoneDeck development. This section is for developers and contributors: how to run the project locally, what is expected of contributions, how the project is managed, and how the system is designed.

TIP

If you only want to use ZoneDeck, read the user guide instead.

Technology overview ​

v3 is a complete rewrite. The main choices:

PartTechnology
Resident coreRust (fully native, calling the Windows API directly)
Settings backendTauri 2 (Rust)
Settings frontendSvelte 5 + Vite
Inter-process communicationNamed pipe (one JSON object per line)
Project layoutCargo workspace + an npm frontend subproject
PackagingPowerShell scripts + Inno Setup
CI/CDGitHub Actions

Design goals ​

The goals behind the v3 rewrite:

  • Lower memory: a resident core binary of about 350 KB using roughly 1 MB in the background.
  • More stable: crash logs, crash recovery and a watchdog form three layers of defence.
  • A single native binary: no Python runtime, which reduces antivirus false positives.
  • A more modern settings window: frameless, themeable, saving automatically.

Suggested reading order ​

  1. Running locally — environment setup and common commands; get the project running first.
  2. Architecture — the overall two-process plus named-pipe design.
  3. Frontend & settings UI — the Svelte / Tauri choices and structure.
  4. Contribution guide and Project management — required reading before collaborating.
  5. Testing strategy and Packaging & releasing — quality and delivery.

Reference material: Configuration fields, IPC protocol.

Repository ​

https://github.com/IvanHanloth/ZoneDeck