ZREQ // ENGINEERING REPORT

// status · architecture · roadmap

Home GitHub

Status: in development. The desktop shell builds (Tauri v2) and mounts the engine; the engine's exact per-feature Postman coverage is hand-assessed conservatively in the zreq-core port report (a generator that can only flag overclaims, never inflate). This page describes the architecture and roadmap.

What zreq is

zreq is a from-scratch desktop API client (Postman port) written in Rust. The desktop shell is a Tauri v2 application with a cyberpunk HUD front-end and an embedded terminal. The API-client logic is factored out into a separate, embeddable engine, zreq-core, so the same engine can be reused inside the other MenkeTechnologies GUI apps without dragging GUI or platform dependencies into them. It is a paid product, created by MenkeTechnologies.

Two-layer split

layerrepositoryresponsibility
desktop appzreq (this repo)Tauri v2 shell, cyberpunk HUD front-end, embedded terminal, action-to-engine wiring
API enginezreq-coreembeddable API-client logic (collections, requests, environments, auth, HTTP, history, codegen, import/export), decoupled from any GUI

How the shell mounts the engine

The host registers the engine's single Tauri command and event sink, and serves the engine's mountable webui. The WebView calls one JSON command surface; all HTTP egress happens in Rust, not the WebView.

tauri::Builder::default()
    .invoke_handler(tauri::generate_handler![zreq_core::tauri_plugin::zrq_invoke, /* terminal cmds */])
    .setup(|app| { zreq_core::tauri_plugin::setup(app.handle())?; Ok(()) })
    .run(tauri::generate_context!())

Roadmap

Directions for the desktop layer. Per-feature engine coverage is in the zreq-core port report, not duplicated here.

areastatusnotes
Tauri v2 shellimplementeddesktop window, IPC bridge, engine + embedded-terminal commands wired
zreq-core integrationimplementedmounts the embeddable engine + its webui as the single source of API-client logic
Cyberpunk HUD UIimplementedshared MenkeTechnologies HUD design language (this docs site uses it)
Command palette / i18nplannedshared zpwr-i18n catalog + palette across the desktop stack
Request cancellation & collection runnerplannedtracked in the zreq-core port report as missing

Documentation

For the project overview see the home page. The engine is tracked in its own repository, zreq-core, with its Postman port report.