Concepts
Architecture overview
Modules, the request/response flow, and provider selection.
JDesk is built on Java 25 plus the OS WebView. Application logic runs on the JVM (JPMS modules, virtual threads, FFM); the UI is any static web build.
The module map#
- jdesk-api — the public Java API surface.
- jdesk-runtime — lifecycle, IPC protocol v1, capability engine, asset resolver.
- jdesk-platform-* — Windows/macOS/Linux WebView adapters.
- jdesk-codegen — the annotation processor (compile-time registration + TypeScript client).
- jdesk-gradle-plugin — dev loop, build, and packaging tasks.
Provider selection#
The runtime never scans the classpath. JDeskApplication.run() loads exactly one PlatformProvider via ServiceLoader; zero or many is a fatal error.