Skip to content

feat: Add Always on Top window functionality #108

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

Jump to bottom
Open
J3n5en wants to merge 2 commits into
base: main
Choose a base branch
from
Open

feat: Add Always on Top window functionality #108

J3n5en wants to merge 2 commits into from

Conversation

@J3n5en
Copy link

@J3n5en J3n5en commented Dec 9, 2025

Summary

  • Add alwaysOnTop option to BrowserWindow constructor
  • Add setAlwaysOnTop(boolean) method for runtime toggling
  • Add alwaysOnTop getter to check current state

Changes

  • macOS: Use NSFloatingWindowLevel / NSNormalWindowLevel
  • Linux: Use gtk_window_set_keep_above (GTK) or
    _NET_WM_STATE_ABOVE (X11)
  • Windows: Use SetWindowPos with HWND_TOPMOST /
    HWND_NOTOPMOST

Usage

// Set on creation
const win = new BrowserWindow({
  alwaysOnTop: true,
  // ...
});

// Toggle at runtime
win.setAlwaysOnTop(true);
win.setAlwaysOnTop(false);

// Check state
console.log(win.alwaysOnTop);

Test Plan

  • Run bun run:playground and test Always on Top checkbox in Window
    Demo
  • Run bun test and execute the "Window Always on Top" test case
  • Verify window stays on top when other windows are focused
  • Verify toggling off allows window to go behind others

J3n5en added 2 commits December 9, 2025 11:09
@J3n5en
feat: add Always on Top window functionality
bc71581 
- Add setWindowAlwaysOnTop native function for macOS, Linux, and Windows
- Add FFI binding for setWindowAlwaysOnTop in native.ts
- Add alwaysOnTop option to WindowOptionsType
- Add setAlwaysOnTop() method and alwaysOnTop getter to BrowserWindow
- Enable Always on Top in interactive-playground demo
- Add window-always-on-top test case
@J3n5en
refactor: make alwaysOnTop property private with getter
74fc391 
Change alwaysOnTop from public property to private _alwaysOnTop
with a readonly getter. Users should use setAlwaysOnTop() method
to modify the value.
imclaren01
imclaren01 reviewed Dec 28, 2025
View reviewed changes
src/bun/core/BrowserWindow.ts
}

setAlwaysOnTop(alwaysOnTop: boolean) {
this._alwaysOnTop = alwaysOnTop;
Copy link

@imclaren01 imclaren01 Dec 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick: only do this if alwaysOnTop != this._alwaysOnTop?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

1 more reviewer

@imclaren01 imclaren01 imclaren01 left review comments

Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@J3n5en @imclaren01