Skip to content

A comprehensive Zen Browser mod that enhances the main content area with refined geometry, elegant borders, and smooth loading animations.

License

Notifications You must be signed in to change notification settings

dithmar1/Enhanced-Content-Container

Repository files navigation

Enhanced Content Container

A comprehensive Zen Browser mod that transforms the main content area with refined geometry, elegant borders, advanced content clipping, and smooth loading animations—all while maintaining optimal GPU performance.

📸 Before & After

Empty Window

Before After
Before - Empty Window After - Empty Window

Rendered Page

Before After
Before - Rendered Page After - Rendered Page

✨ Features

🎨 Visual Enhancements

  • Rounded corners - Clean 8px border radius on the main content container
  • Subtle border - Elegant semi-transparent border (15% opacity) that adapts to themes
  • Depth shadow - Dark exterior shadow for elegant depth and relief effect
  • Native mica/acrylic - Preserves Zen Browser's native transparency effect for modern aesthetic
  • Refined spacing - Optimized margins with subtle left offset for better visual balance
  • Theme integration - Automatically adapts to Zen Browser's theme colors

🔒 Advanced Content Clipping

  • Zero overflow - Multi-layer clipping system with clip-path applied at each level prevents content from spilling beyond rounded borders
  • Border preservation - Unique wrapper architecture keeps borders visible while clipping content internally
  • Render stability - Multiple clip-paths ensure content remains contained during initial page render, preventing brief overflow flashes
  • Smart full-screen - Intelligently differentiates between content full-screen (videos) and browser F11 mode, removing effects only for media content

⚡ Loading Experience

  • Smooth loading mask - Elegant overlay that fades out when content is ready (0.12s transition)
  • Shimmer effect - Subtle animated gradient during page loading for visual feedback
  • Background tab optimization - Disabled transitions for inactive tabs to save resources

🚀 Performance Optimizations

  • Reduced GPU layers - Optimized from 7 to 3 essential GPU layers (57% reduction)
  • Efficient rendering - Removed expensive SVG masks and unnecessary transforms
  • Content visibility - Smart rendering hints for better browser performance
  • Balanced approach - Multi-level clip-paths maintained for visual stability during render, ensuring zero overflow at all times

🏗️ Technical Details

Architecture

The mod uses a sophisticated multi-layer clipping approach:

  1. Outer wrapper (#tabbrowser-tabpanels) - Draws the visible border without clipping
  2. Primary clipping layer (::before pseudo-element) - Main clipping boundary
  3. Secondary clipping layers - Additional clip-paths applied at each container level (#webext-panels-stack, .browserContainer, browser[type="content"], #appcontent deck)

This multi-level approach ensures borders remain visible while content is perfectly contained at all times, including during initial page render when content might otherwise briefly overflow.

Customization

All visual properties are controlled via CSS variables:

  • --zen-content-radius: Border radius (default: 8px)
  • --zen-content-margin: Container margin (default: 2px)
  • --zen-border-color: Border color (default: rgba(255, 255, 255, 0.15))
  • --zen-border-width: Border width (default: 1px)
  • --zen-shadow-color: Shadow color (default: rgba(0, 0, 0, 0.25))
  • --zen-shadow-blur: Shadow blur radius (default: 8px)
  • --zen-shadow-spread: Shadow spread (default: 4px)
  • --zen-shadow-offset-y: Shadow vertical offset (default: 2px)

📦 Installation

Enable the mod directly from the Zen Mods Store.

✅ Compatibility

Tested with latest Zen Browser builds. Fully compatible with all Zen Browser themes.

📊 Performance Impact

  • GPU Usage: Optimized
  • Memory: Minimal overhead with smart containment strategies
  • Rendering: Multi-level clipping ensures visual stability, reduced GPU layers maintain performance

📄 License

MIT

About

A comprehensive Zen Browser mod that enhances the main content area with refined geometry, elegant borders, and smooth loading animations.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages