Add native desktop app via Wails v3 (hetty-desktop) - #156
Open
dindindudu0-lab wants to merge 1 commit into
Open
Conversation
Extract HTTP server bootstrap into pkg/server so the CLI and a new hetty-desktop binary share the same stack. The desktop app embeds the admin UI and opens it in a Wails v3 window on localhost. Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
pkg/serverso the CLI and a new desktop binary share the same stack (proxy, GraphQL API, embedded admin UI).cmd/hetty-desktop: Wails v3 app that starts Hetty locally and opens the admin interface in a native window (defaulthttp://127.0.0.1:8080).go.mod(cmd/hetty-desktop/go.mod) so the main module stays on Go 1.23 without pulling Wails into the core CLI build.make build-desktopbuildshetty-desktop(requires CGO + Go 1.25 toolchain viaGOTOOLCHAIN).Motivation
Hetty today expects users to open a browser tab or use
hetty --chrome. A native desktop shell improves discoverability on Linux/macOS/Windows and matches tooling expectations for security researchers who want a dedicated app window.Test plan
go test ./pkg/...make build(CLI)make build-desktopon Linux with webkit2gtk + CGO./hetty-desktop, verify admin UI loads and proxy logs workLinux build notes
Requires
libwebkit2gtk-4.1-dev(orlibwebkit2gtk-4.0-dev) and a C compiler. Documented in README.Screenshots
Desktop window loads the existing embedded admin UI at the local Hetty URL — no frontend changes required.
Made with Cursor