WindowProps

Defined in: shared/types.ts:543

Window component props (renderer process)

Extends

• BaseWindowProps

Properties

alwaysOnTop?

optional alwaysOnTop: boolean | AlwaysOnTopLevel

Defined in: shared/types.ts:432

Whether the window should always be on top.

Inherited from

BaseWindowProps.alwaysOnTop

---

backgroundColor?

optional backgroundColor: string

Defined in: shared/types.ts:402

Background color

Inherited from

BaseWindowProps.backgroundColor

---

center?

optional center: boolean

Defined in: shared/types.ts:370

Center the window on creation. Default: true if no x/y specified.

Inherited from

BaseWindowProps.center

---

children

children: ReactNode

Defined in: shared/types.ts:545

Content to render inside the window

---

closable?

optional closable: boolean

Defined in: shared/types.ts:310

Whether the user can close the window. Default: true. When false, the close button is hidden/disabled.

Inherited from

BaseWindowProps.closable

---

defaultHeight?

optional defaultHeight: number

Defined in: shared/types.ts:318

Initial height. Only applied on window creation.

Inherited from

BaseWindowProps.defaultHeight

---

defaultWidth?

optional defaultWidth: number

Defined in: shared/types.ts:315

Initial width. Only applied on window creation.

Inherited from

BaseWindowProps.defaultWidth

---

defaultX?

optional defaultX: number

Defined in: shared/types.ts:321

Initial x position. Only applied on window creation.

Inherited from

BaseWindowProps.defaultX

---

defaultY?

optional defaultY: number

Defined in: shared/types.ts:324

Initial y position. Only applied on window creation.

Inherited from

BaseWindowProps.defaultY

---

focusable?

optional focusable: boolean

Defined in: shared/types.ts:429

Whether the window is focusable. Default: true.

Inherited from

BaseWindowProps.focusable

---

frame?

optional frame: boolean

Defined in: shared/types.ts:387

Show window frame (title bar, borders). Creation-only.

Creation Only

Cannot be changed after window creation.

Inherited from

BaseWindowProps.frame

---

fullscreen?

optional fullscreen: boolean

Defined in: shared/types.ts:443

Enter/exit fullscreen mode

Inherited from

BaseWindowProps.fullscreen

---

fullscreenable?

optional fullscreenable: boolean

Defined in: shared/types.ts:446

Whether the window can enter fullscreen. Default: true.

Inherited from

BaseWindowProps.fullscreenable

---

height?

optional height: number

Defined in: shared/types.ts:338

Controlled height. Changes will resize the window. Use with onBoundsChange for two-way sync.

Inherited from

BaseWindowProps.height

---

ignoreMouseEvents?

optional ignoreMouseEvents: boolean

Defined in: shared/types.ts:454

Ignore mouse events (click-through window)

Inherited from

BaseWindowProps.ignoreMouseEvents

---

injectStyles?

optional injectStyles: InjectStylesMode

Defined in: shared/types.ts:502

How to inject styles into the new window.

• “auto”: Copy
• false: No injection (for CSS-in-JS)
• function: Custom injection

Inherited from

BaseWindowProps.injectStyles

---

maxHeight?

optional maxHeight: number

Defined in: shared/types.ts:367

Maximum height constraint

Inherited from

BaseWindowProps.maxHeight

---

maximizable?

optional maximizable: boolean

Defined in: shared/types.ts:426

Whether the window can be maximized. Default: true.

Inherited from

BaseWindowProps.maximizable

---

maxWidth?

optional maxWidth: number

Defined in: shared/types.ts:361

Maximum width constraint

Inherited from

BaseWindowProps.maxWidth

---

minHeight?

optional minHeight: number

Defined in: shared/types.ts:364

Minimum height constraint

Inherited from

BaseWindowProps.minHeight

---

minimizable?

optional minimizable: boolean

Defined in: shared/types.ts:423

Whether the window can be minimized. Default: true.

Inherited from

BaseWindowProps.minimizable

---

minWidth?

optional minWidth: number

Defined in: shared/types.ts:358

Minimum width constraint

Inherited from

BaseWindowProps.minWidth

---

movable?

optional movable: boolean

Defined in: shared/types.ts:420

Whether the window is movable. Default: true.

Inherited from

BaseWindowProps.movable

---

name?

optional name: string

Defined in: shared/types.ts:484

Debug name for DevTools and error messages. Useful for identifying windows in multi-window apps.

Inherited from

BaseWindowProps.name

---

onBlur()?

optional onBlur: () => void

Defined in: shared/types.ts:525

Fired when the window loses focus

Returns

void

Inherited from

BaseWindowProps.onBlur

---

onBoundsChange()?

optional onBoundsChange: (bounds) => void

Defined in: shared/types.ts:353

Callback fired when window bounds change (resize or move). Debounced internally.

Parameters

bounds

Bounds

Returns

void

Inherited from

BaseWindowProps.onBoundsChange

---

onClose()?

optional onClose: () => void

Defined in: shared/types.ts:528

Fired when the window is destroyed (for any reason — user close, programmatic, unmount)

Returns

void

Inherited from

BaseWindowProps.onClose

---

onDisplayChange()?

optional onDisplayChange: (display) => void

Defined in: shared/types.ts:537

Fired when window moves to a different display

Parameters

display

DisplayInfo

Returns

void

Inherited from

BaseWindowProps.onDisplayChange

---

onEnterFullscreen()?

optional onEnterFullscreen: () => void

Defined in: shared/types.ts:531

Fired when window enters fullscreen

Returns

void

Inherited from

BaseWindowProps.onEnterFullscreen

---

onExitFullscreen()?

optional onExitFullscreen: () => void

Defined in: shared/types.ts:534

Fired when window exits fullscreen (maps to Electron’s ‘leave-full-screen’ event)

Returns

void

Inherited from

BaseWindowProps.onExitFullscreen

---

onFocus()?

optional onFocus: () => void

Defined in: shared/types.ts:522

Fired when the window gains focus

Returns

void

Inherited from

BaseWindowProps.onFocus

---

onMaximize()?

optional onMaximize: () => void

Defined in: shared/types.ts:510

Fired when window is maximized

Returns

void

Inherited from

BaseWindowProps.onMaximize

---

onMinimize()?

optional onMinimize: () => void

Defined in: shared/types.ts:516

Fired when window is minimized

Returns

void

Inherited from

BaseWindowProps.onMinimize

---

onReady()?

optional onReady: () => void

Defined in: shared/types.ts:507

Fired when window is ready and content is mounted

Returns

void

Inherited from

BaseWindowProps.onReady

---

onRestore()?

optional onRestore: () => void

Defined in: shared/types.ts:519

Fired when window is restored from minimized

Returns

void

Inherited from

BaseWindowProps.onRestore

---

onUnmaximize()?

optional onUnmaximize: () => void

Defined in: shared/types.ts:513

Fired when window is unmaximized

Returns

void

Inherited from

BaseWindowProps.onUnmaximize

---

onUserClose()?

optional onUserClose: () => void

Defined in: shared/types.ts:304

Called when the user initiates a close (e.g., clicks the X button).

Fires during Electron’s close event — the window is about to close but hasn’t yet. Use this to sync your open state back to false. The window will close on its own; your open={false} is for your state consistency, not to drive the close.

This is a notification, not an interceptor. To prevent close, set closable={false} proactively (e.g., closable={!hasUnsavedChanges}).

onClose (a separate callback) fires after the window is fully destroyed, for any reason (user, programmatic, unmount).

Returns

void

Inherited from

BaseWindowProps.onUserClose

---

opacity?

optional opacity: number

Defined in: shared/types.ts:405

Window opacity (0.0 to 1.0)

Inherited from

BaseWindowProps.opacity

---

open

open: boolean

Defined in: shared/types.ts:288

Whether the window should be open/visible. When true, the window is created/shown. When false, the window is destroyed.

Inherited from

BaseWindowProps.open

---

persistBounds?

optional persistBounds: string

Defined in: shared/types.ts:492

Persist window bounds with this key. Bounds are saved on resize/move and restored on next open.

Inherited from

BaseWindowProps.persistBounds

---

recreateOnShapeChange?

optional recreateOnShapeChange: boolean

Defined in: shared/types.ts:478

Recreate window when creation-only props change. Default: false (log warning instead).

Inherited from

BaseWindowProps.recreateOnShapeChange

---

resizable?

optional resizable: boolean

Defined in: shared/types.ts:417

Whether the window is resizable. Default: true.

Inherited from

BaseWindowProps.resizable

---

showInactive?

optional showInactive: boolean

Defined in: shared/types.ts:451

Show window without stealing focus

Inherited from

BaseWindowProps.showInactive

---

skipTaskbar?

optional skipTaskbar: boolean

Defined in: shared/types.ts:438

Whether to skip showing in taskbar/dock.

Inherited from

BaseWindowProps.skipTaskbar

---

targetDisplay?

optional targetDisplay: TargetDisplay

Defined in: shared/types.ts:470

Which display to open the window on

Inherited from

BaseWindowProps.targetDisplay

---

title?

optional title: string

Defined in: shared/types.ts:375

Window title

Inherited from

BaseWindowProps.title

---

titleBarOverlay?

optional titleBarOverlay: TitleBarOverlayOptions

Defined in: shared/types.ts:465

Title bar overlay options (Windows)

Inherited from

BaseWindowProps.titleBarOverlay

---

titleBarStyle?

optional titleBarStyle: TitleBarStyle

Defined in: shared/types.ts:393

Title bar style. Creation-only.

Creation Only

Cannot be changed after window creation.

Inherited from

BaseWindowProps.titleBarStyle

---

trafficLightPosition?

optional trafficLightPosition: object

Defined in: shared/types.ts:462

Traffic light (close/minimize/maximize) button position (macOS)

x

x: number

y

y: number

Inherited from

BaseWindowProps.trafficLightPosition

---

transparent?

optional transparent: boolean

Defined in: shared/types.ts:381

Make the window transparent. Creation-only.

Creation Only

Cannot be changed after window creation.

Inherited from

BaseWindowProps.transparent

---

vibrancy?

optional vibrancy: VibrancyType

Defined in: shared/types.ts:399

Vibrancy effect (macOS only). Creation-only.

Creation Only

Cannot be changed after window creation.

Inherited from

BaseWindowProps.vibrancy

---

visible?

optional visible: boolean

Defined in: shared/types.ts:414

Whether the window is visible. Default: true. Set to false to hide the window without destroying it (state is preserved). Unlike open, which controls the window’s existence, visible controls whether it’s shown.

Inherited from

BaseWindowProps.visible

---

visibleOnAllWorkspaces?

optional visibleOnAllWorkspaces: boolean

Defined in: shared/types.ts:457

Visible on all workspaces/virtual desktops

Inherited from

BaseWindowProps.visibleOnAllWorkspaces

---

width?

optional width: number

Defined in: shared/types.ts:332

Controlled width. Changes will resize the window. Use with onBoundsChange for two-way sync.

Inherited from

BaseWindowProps.width

---

x?

optional x: number

Defined in: shared/types.ts:344

Controlled x position. Changes will move the window. Use with onBoundsChange for two-way sync.

Inherited from

BaseWindowProps.x

---

y?

optional y: number

Defined in: shared/types.ts:350

Controlled y position. Changes will move the window. Use with onBoundsChange for two-way sync.

Inherited from

BaseWindowProps.y