Skip to content

Refactor UI Geometry, Popup Architecture, and Sizing - #81

Merged
Brainitech merged 3 commits into
devfrom
refactor/geometry-sizing-border
Aug 24, 2026
Merged

Refactor UI Geometry, Popup Architecture, and Sizing#81
Brainitech merged 3 commits into
devfrom
refactor/geometry-sizing-border

Conversation

@Brainitech

Copy link
Copy Markdown
Owner

Overview

This PR fundamentally improves how the shell's UI geometry—specifically borders, corner roundness, and padding—is calculated and rendered. Previously, the UI relied on hardcoded values and workarounds that caused visual glitches (clipping, overlapping, or broken shapes) when adjusting customization settings. This refactor makes the UI components more robust, seamless, and adaptable for future feature additions.

What's Changed & Why

1. Unified Rounding & Geometry

  • What: Consolidated multiple rounding values into a single global roundness setting. Added mathematical safety limits (clamping) to the Top Bar's "notch" shape.
  • Why: Prevents the UI's geometry from breaking or folding in on itself when you set extreme border widths or corner radii. Rounding changes now apply universally and cleanly.

2. Popup Architecture Overhaul

  • What: Migrated popups (like the Arch Menu, Audio, and Quick Controls) from being their own standalone, independent windows into integrated components living directly within the shell's existing borders and Top Bar.
  • Why: This drastically simplifies how the system handles mouse clicks, hovers, and window masks. Popups now behave as true, seamless extensions of the shell rather than disconnected floating windows.

3. Visual Alignment & Anti-Clipping Fixes

  • What:
    • Removed hardcoded dependencies in the Top Bar so icons remain perfectly centered regardless of border thickness.
    • Fixed canvas clipping bugs where content would get cut off inside heavily rounded corners.
    • Made Quick Control sizes dynamic based on available screen space rather than fixed heights.
  • Why: Eliminates awkward visual artifacts, ensuring the UI looks premium, polished, and proportional under any customization setup.

4. Animation & Responsiveness Tweaks

  • What: Fixed animation timings and ensured that custom shapes (like the Top Bar and popups) instantly repaint themselves the moment a size or border setting is changed.
  • Why: Keeps the interface feeling fluid, responsive, and glitch-free when tweaking aesthetics on the fly.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (causes existing functionality to not work as expected)

Testing Checklist

  • I have tested these changes locally and on a fresh VM install.
  • I have tested the QML UI on my primary resolution.
  • (If applicable) I have tested UI changes on secondary monitors or different resolutions.
  • (If applicable) I have verified my bash scripts run cleanly without syntax errors.

Related Issues

Side Popups Detachement during spring curve animations

Border Thickness Updates On change

Re-enabled Border and Corner Customizations Options

Enhanced Screen-Recording Options UI
@Brainitech
Brainitech merged commit c76ab1d into dev Aug 24, 2026
3 checks passed
@Brainitech
Brainitech deleted the refactor/geometry-sizing-border branch August 24, 2026 01:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant