Safari Dark Mode Field Notes

Dark mode for Safari, explained from the rendering layer up.

Practical guides, real-site compatibility notes, and technical explanations for making the web easier to read after dark—without pretending every website behaves the same.

Maintained from production Swift and JavaScript rendering code.

Safari behavior Browser appearance, extension permissions, page access, and lifecycle constraints.
Website CSS Native color schemes, computed colors, variables, gradients, and site-specific exceptions.
Media handling Images, video, logos, controls, and the elements a dark theme should leave recognizable.
Page lifecycle Navigation, restoration, back-forward cache events, and extension reconnection.

01 / Visual result

A page should still look like itself.

The same Google Search result before and after dark-mode rendering. The page keeps its hierarchy, branding, and controls while the surrounding color relationships change. Drag to compare.

Google Search results for World Wide Web in the Light appearance on iPhone
The same Google Search results after dark-mode rendering on iPhone

02 / Knowledge map

Browse Safari dark mode by problem

Start with a task, a website, a theme decision, or the browser technology underneath it.

03 / Recently updated

Recently updated Safari dark mode notes

Compatibility changes as Safari and websites change. These articles are designed to be revised.

04 / Rendering notes

How Safari dark mode rendering works

These are implementation details, not marketing categories. Each step maps to behavior in the production extension and its rendering engine.

01 Detect

Respect the site first

The extension watches native color-scheme signals and site-specific detector hints. If a page already has a dark theme, the default behavior can stand down.

02 Read

Understand the page CSS

The dynamic engine reads colors, variables, gradients, backgrounds, text, and borders before it decides what should change.

03 Protect

Keep media recognizable

Images are handled separately, while compatibility rules can exclude logos, video, controls, and other elements that should stay intact.

04 Resume

Stay reliable through navigation

Explicit page lifecycle handling reconnects the extension after Safari navigation, page restoration, and back-forward cache events.