Skip to content

Bug: Sidebar not rendered in Safari #80

@mizmay

Description

@mizmay

Version: zensical-0.0.24
Theme: modern (default)
Browser: Safari (macOS) — Chrome , Firefox unaffected

Description

The navigation sidebar is present in the DOM but not visually rendered in Safari when using the modern theme. The page appears as a single-column layout with no sidebar navigation.

Steps to reproduce

  1. Build a site with Zensical using the modern theme
    (default)
  2. Open in Safari on macOS
  3. Compare to Chrome — sidebar visible in Chrome,
    absent in Safari

What I checked

  • Sidebar HTML is fully present in the DOM
    (div.md-sidebar.md-sidebar--primary with complete
    nav structure)
  • No JavaScript errors in Safari console
  • <html> element correctly has class="js" (JS
    executed successfully)
  • Chrome renders the sidebar correctly from identical
    HTML

Possible culprits

Faulty viewport width logic causing Safari to detect desktop screen as a tablet? If I extend the window well past the width of my extended monitor, it flips to Desktop css and the sidebar appears.

Workaround

EDIT: this fixed it when I tested locally, but the issue persists the "classic" theme when deployed.

Adding variant: classic to mkdocs.yml restores the
sidebar in Safari:

Before After
Screenshot 2026-03-04 at 2 17 38 PM Screenshot 2026-03-04 at 2 17 58 PM

More info: maplibre/maplibre-style-spec#1529

theme:
name: material
variant: classic

Environment

  • macOS Sequoia
  • Safari Version 18.6 (20621.3.11.11.3)
  • zensical 0.0.24

Metadata

Metadata

Assignees

No one assigned

    Labels

    working as intendedIssue reports behavior in line with specification

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions