Skip to content

docs(runtime): document initial window configuration #3469

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sasivarnan wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(runtime): document initial window configuration #3469

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 31 additions & 2 deletions runtime/desktop/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
last_modified: 2026-06-30
last_modified: 2026-09-07
title: "Configuration"
description: "Configure deno desktop in deno.json: app metadata, icons, deep-link URL schemes, backend selection, output paths, error reporting, and the auto-update server."
description: "Configure deno desktop in deno.json: app metadata, initial window options, icons, deep-link URL schemes, backend selection, output paths, error reporting, and the auto-update server."
---

:::info Available in Deno 2.9
Expand Down Expand Up @@ -209,6 +209,35 @@ result is not distributable without further signing. Set a real Developer ID
identity to produce a notarizable bundle. See
[Distribution](/runtime/desktop/distribution/#code-signing).

## `initialWindow`

Configure the implicit first window created before your application code runs.
This is useful when its creation-time properties must differ from the defaults;
the first `new Deno.BrowserWindow()` adopts this window rather than creating a
new one.

```jsonc title="deno.json"
{
"desktop": {
"initialWindow": {
"width": 320,
"height": 220,
"frameless": true,
"noActivate": true,
"transparent": true,
"showOnFirstLoad": false
}
}
}
```

All fields are optional. The defaults preserve the standard 800×600, decorated,
activating, opaque window that appears after its first page load. `frameless`,
`noActivate`, `transparentTitlebar`, and `transparent` are applied when macOS,
Windows, or Linux creates the native window, so they cannot be set later by
adopting it in JavaScript. Set `showOnFirstLoad` to `false` when your app will
reveal the adopted window itself.

## `release`

Configuration for the auto-update system.
Expand Down
Loading