docs: add deno desktop reference page#3085
Draft
lunadogbot wants to merge 6 commits into
Draft
Conversation
Adds a CLI reference page for the new (experimental) deno desktop subcommand which builds self-contained desktop apps from a Deno project. Documents the three rendering backends (cef / webview / raw), framework auto-detection, HMR, the Deno.BrowserWindow / Deno.Tray / Deno.dock APIs, the unified DevTools session, the auto-updater, the cross-compile output formats, and the new \`desktop\` block in deno.json. Marks the surface as still evolving. Adds entries to the CLI index and sidebar. Refs denoland/deno#33441
Adds a new runtime/desktop/ section with 16 guides covering configuration, backends, framework auto-detection, HTTP serving, the BrowserWindow API, bindings, menus, tray/dock, dialogs, HMR, unified DevTools, auto-update, error reporting, distribution, and a comparison vs Electron/Tauri/etc. Slims down runtime/reference/cli/desktop.md to a flag reference that links into the new section, and wires up the sidebar in runtime/_data.ts. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Drops `command: desktop` and `openGraph*` frontmatter so renderCommand.tsx isn't invoked — there is no `desktop` entry in `_commands_reference.json` yet, and the renderer accesses `.about` unconditionally. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
fibibot
reviewed
May 17, 2026
Contributor
fibibot
left a comment
fibibot
left a comment
There was a problem hiding this comment.
This PR adds 2,701 lines, which is over the scheduled-review size limit. Can this be split into smaller PRs, for example the reference page skeleton first and the generated/long-form sections separately?
Member
|
Deferred from this release |
crowlKats
changed the title
deno desktop reference page (2.8)deno desktop reference page
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
3 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
Adds a reference page for the new (experimental)
deno desktopsubcommand from the 2.8 milestone (denoland/deno#33441). The page documents the public-facing surface in the upstream PR and explicitly marks it experimental, since the API is still evolving.Covered:
deno desktop .).cef,webview,raw— and how WEF binaries are downloaded/cached.--hmrflow.Deno.BrowserWindowAPI surface (window lifecycle,bind/unbindRPC,executeJs, menus, native handle), plusDeno.dockandDeno.Tray.prompt()/alert()/confirm()and thedesktop.errorReporting.urlhook.--inspect/--inspect-brk/--inspect-wait).Deno.autoUpdate,Deno.desktopVersion)..app/.dmg/.exe/.AppImage).desktopconfig block indeno.json.Also notes what is not yet implemented (codesigning, MSI, deb/rpm, notifications, clipboard, secureStorage).
Sidebar entry in
runtime/_data.ts, entry in the CLI index page.Test plan
deno task serve— page renders, sidebar entry resolves.