vercel / vercel/hyper

windowFrame: 'native' has no effect on Linux (Cinnamon)

Open
#8,198 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
44.7k
Forks
3.6k
Avg merge
21m
Merged PRs (30d)
1

Description

Environment

  • Hyper: v3.4.1 (deb)
  • OS: Linux Mint 22.3, Cinnamon 6.6.7
  • Window manager: Muffin (Cinnamon)

Issue

Setting windowFrame: 'native' in ~/.hyper.js config has no effect on Linux with Cinnamon desktop. Hyper still renders its custom titlebar with no maximize button.

The custom titlebar lacks a maximize button on Linux (only close and minimize are shown). There is no way to use system window decorations (server-side decorations) instead of Hyper's custom CSD.

Expected

windowFrame: 'native' should make Hyper use the system window manager decorations (including maximize, minimize, close buttons matching the system theme).

Screenshots

Screenshot showing custom titlebar without maximize button.

Additional context

The showWindowControls option only controls custom minimize/maximize/close drawn by Hyper itself, but doesn't switch to native system decorations.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the handling of windowFrame and showWindowControls from ~/.hyper.js, then trace the Linux window-decoration setup for Cinnamon/Muffin. Reproduce the issue on Linux Mint with Cinnamon and verify that windowFrame: 'native' produces system decorations, including maximize, minimize, and close controls, without relying on Hyper's custom titlebar.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux, typescript
Domain
desktop, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.