Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

feat(widget): dockear al monitor principal por defecto y avisar si el widget queda en otro display

Open
  • Is something wrong?
#113 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
rust, typescript
Domain
desktop, frontend

Research direction

Start where the frontend resolves the dock geometry when dockMonitor is null and find the currentMonitor() call that should become primaryMonitor(). The Rust geometry code the issue mentions is the second place to check. Done means a null dockMonitor docks to the primary display, and a notice or re-dock happens when the strip shows on a non-primary display. The issue asks for product review before implementation, so confirm the behavior with the maintainer first.

Written by the indexing model from the issue text.

Description

Pre-flight checks
  • Busqué issues existentes y no encontré duplicados.
  • Entiendo que esta propuesta requiere revisión de producto antes de implementarse.
Problem to solve

Descubierto durante el port a macOS (#69, verificación M3): con dockMonitor: null, el frontend resuelve la posición del widget con currentMonitor() (el monitor "actual", que depende de dónde esté el cursor/foco) en vez del monitor principal. En un setup multi-display el widget puede dockearse al borde de un monitor externo — incluso uno ubicado fuera de la vista natural del usuario (arriba del principal) — y como la tira en modo peek es una franja fina (~210 px), el widget parece "desaparecido".

Reproducción real: macOS multi-display (Retina principal + externos, uno de 3008×1692 arriba del principal), dockEdge: "top", dockOffset: 0.53, dockMonitor: null → la ventana del widget quedó en y = -1692 (borde superior del externo). En Windows no se nota porque la taskbar vive en el display principal; el dockeo actual nunca tuvo este caso a la vista.

Proposed solution

Dos cambios de comportamiento (ambos acotados al frontend/Rust de geometría ya existente):

  1. Con dockMonitor: null, resolver la geometría contra el monitor principal (primaryMonitor()) por defecto, no contra currentMonitor(). El "actual" queda solo cuando el usuario fijó explícitamente un monitor en Ajustes.
  2. Al mostrar la tira en un display no principal, emitir una notificación/aviso breve ("Quorb está en el monitor X") o re-dockear al principal si el elegido no está visible.
Affected area

Application behavior

Scope and non-goals

Incluye: default de monitor para el dockeo, aviso/redock de seguridad. No incluye: soporte de widget simultáneo en varios displays, gestión de perfiles por display, cambios de estilo del widget, ni la validación del port macOS (eso sigue en #69 / PR #112).

Alternatives considered
  • Dejar el comportamiento actual y solo documentarlo: descartado, el "widget invisible" es una mala primera experiencia en multi-display.
  • Recordar el último monitor por coordenadas de ventana en vez de por nombre: frágil si cambia la disposición de displays; el nombre + fallback a principal es más estable.
Dominant language
TypeScript
Stars
10
Forks
2
Avg merge
2h 20m
Merged PRs (30d)
64

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

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.

More from egdev6/quorb

All issues in egdev6/quorb

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.