Find a file
Ben Williams 90d8514059
gpui_macos: Fix blurred window backgrounds on macOS 27 (#65361)
## Summary

On macOS 27, `WindowBackgroundAppearance::Blurred` doesn't blur
anything: the window is only transparent, so whatever is behind it shows
through sharp. In Zed, this affects themes with
`"background.appearance": "blurred"`.

`BlurredView` is an `NSVisualEffectView` with the `Selection` material,
and `blurred_view_update_layer` strips the material's tint and
saturation so that only its backdrop blur remains. On macOS 27,
`Selection` no longer has a `CABackdropLayer`, so there's no blur left
to keep. This switches to `UnderWindowBackground`, which still has one,
so the existing stripping leaves the same colorless blur as before. It
also sets the behind-window blending mode explicitly (it's already the
default).

#64284 describes the same root cause, and #62605 proposed the same
change; it was closed while waiting on the before/after screenshots
requested there, which are below.

A translucent window with `WindowBackgroundAppearance::Blurred` over a
striped window, on macOS 27.0 (26A428):

| Before (`main`) | After (this PR) |
| --- | --- |
| <img width="680" alt="Before: the stripes behind the translucent
window are sharp"
src="https://github.com/user-attachments/assets/5ec94418-7313-4595-bf29-6a6646454a24"
/> | <img width="680" alt="After: the stripes behind the translucent
window are blurred"
src="https://github.com/user-attachments/assets/2901e570-8db9-4e1f-a152-fc8c1895e0c3"
/> |

<details>
<summary>Example</summary>

```rust
use std::rc::Rc;

use gpui::{
    AppContext as _, Application, Bounds, Context, IntoElement, Render, Window,
    WindowBackgroundAppearance, WindowBounds, WindowOptions, div, point, prelude::*, px, rgb, rgba,
    size,
};
use gpui_macos::MacPlatform;

struct Stripes;

impl Render for Stripes {
    fn render(&mut self, _: &mut Window, _: &mut Context<Self>) -> impl IntoElement {
        let colors = [0xff3b30, 0xffffff, 0x007aff, 0x000000];
        div()
            .size_full()
            .flex()
            .children((0..60).map(move |i| div().w(px(24.)).h_full().bg(rgb(colors[i % 4]))))
    }
}

struct Translucent;

impl Render for Translucent {
    fn render(&mut self, _: &mut Window, _: &mut Context<Self>) -> impl IntoElement {
        div()
            .size_full()
            .flex()
            .items_center()
            .justify_center()
            .bg(rgba(0x0d0e1066))
            .text_color(rgb(0xffffff))
            .text_xl()
            .child("WindowBackgroundAppearance::Blurred")
    }
}

fn main() {
    Application::with_platform(Rc::new(MacPlatform::new(false))).run(|cx| {
        let bounds = |x, y, w, h| {
            Some(WindowBounds::Windowed(Bounds::new(point(px(x), px(y)), size(px(w), px(h)))))
        };
        cx.open_window(
            WindowOptions { window_bounds: bounds(200., 200., 900., 560.), focus: false, ..Default::default() },
            |_, cx| cx.new(|_| Stripes),
        )
        .unwrap();
        cx.open_window(
            WindowOptions {
                window_bounds: bounds(350., 300., 600., 340.),
                window_background: WindowBackgroundAppearance::Blurred,
                ..Default::default()
            },
            |_, cx| cx.new(|_| Translucent),
        )
        .unwrap();
        cx.activate(true);
    });
}
```

</details>

## Testing

- Ran the example above against `main` and against this branch on macOS
27.0 (26A428), Apple silicon: on `main` the stripes behind the window
stay sharp; with this change they're blurred.
- Inspected the `BlurredView`'s layers at runtime: with `Selection`
there's no `CABackdropLayer`; with `UnderWindowBackground` there is one,
and after the existing tint and saturation stripping only its
`sdrNormalize` and `gaussianBlur` filters remain.
- Not tested on macOS 26 or earlier. `UnderWindowBackground` is
available from macOS 10.14.

To check it, run the example on macOS 27, or use a Zed theme with
`"background.appearance": "blurred"` and put a window with sharp detail
behind Zed.

## Self-review

- [x] I've reviewed my diff for quality, security, reliability, and
performance.
- [x] UI changes follow the
[checklist](https://zed.dev/docs/development/ui-checklist).

Release Notes:

- Fixed blurred window backgrounds not blurring on macOS 27.
- [GPUI] Fixed windows with `WindowBackgroundAppearance::Blurred` being
transparent but not blurred on macOS 27.
2026-10-09 13:51:00 +00:00
.agents/skills gpui: Add seeded benchmarks and heap allocation metrics (#64843) 2026-09-28 13:02:30 +00:00
.cargo Reduce release binary sizes (#65168) 2026-10-07 14:56:09 +00:00
.cloudflare Improve docs AI readiness (#59577) 2026-07-08 20:54:51 +00:00
.config extensions_ui: Sync suggested extensions with the live registry (#63211) 2026-09-23 20:50:24 +00:00
.factory Add humanizer skill for AI writing pattern detection (#50021) 2026-02-24 14:58:52 -06:00
.github wezel: Use bundle-linux for size measurements (#65234) 2026-10-06 11:30:37 +00:00
.wezel wezel: Use bundle-linux for size measurements (#65234) 2026-10-06 11:30:37 +00:00
.zed Move some configuration files out of the repository root (#64303) 2026-09-16 14:08:49 +00:00
assets markdown_preview: Fix navigating back to the preview tab (#65299) 2026-10-09 08:37:05 +00:00
ci Move Nightly release to gh-workflow (#41349) 2025-10-28 13:57:23 -06:00
crates gpui_macos: Fix blurred window backgrounds on macOS 27 (#65361) 2026-10-09 13:51:00 +00:00
docs Update edit prediction messaging for the Free plan (#65258) 2026-10-07 16:40:00 +00:00
extensions html: Bump to v0.3.2 (#64371) 2026-09-17 09:59:21 +00:00
legal legal: Use absolute URLs for Terms of Service and Privacy Policy links (#62684) 2026-08-17 09:35:54 +00:00
nix Update nixpkgs and use its WebRTC package (#65203) 2026-10-05 21:03:45 +00:00
script Reduce release binary sizes (#65168) 2026-10-07 14:56:09 +00:00
tooling Fix incorrect LLD used when bundling (#65183) 2026-10-05 15:03:19 +00:00
.git-blame-ignore-revs Add PR 50413 to .git-blame-ignore-revs (#50421) 2026-03-01 00:50:33 +01:00
.gitattributes windows: Make sure zed.sh using the correct line ending (#37650) 2025-09-05 16:25:55 +00:00
.gitignore edit_prediction: Adjust to support Ollama to be used for AI edit prediction (#63519) 2026-09-01 16:07:40 +00:00
.mailmap Update .mailmap (#47413) 2026-01-22 23:57:26 +05:30
.prettierrc ci: Add check for formatting default.json (#30034) 2025-05-06 18:55:26 +00:00
.rules gpui: Add bench_metrics for multi-metric Criterion benchmarks (#64753) 2026-09-27 17:37:29 +00:00
AGENTS.md ai: Symlink an AGENTS.md file to .rules (#45939) 2026-01-19 15:29:42 +01:00
Cargo.lock Bump reported dependencies (#65374) 2026-10-09 09:15:09 +00:00
Cargo.toml gpui_platform: Forward gpui_webs multithreaded feature instead of forcing it (#65289) 2026-10-09 08:23:20 +00:00
CLAUDE.md Initial .rules file for agent with symlinks for other rules file paths (#29014) 2025-04-17 23:41:23 +00:00
clippy.toml Revert "Revert scheduler update (#46659)" (#46671) 2026-01-14 07:19:13 +00:00
CODE_OF_CONDUCT.md Remove community content from docs and point to zed.dev (#19895) 2024-10-29 09:44:58 -04:00
compose.yml Move some configuration files out of the repository root (#64303) 2026-09-16 14:08:49 +00:00
CONTRIBUTING.md Improve contribution guidelines and experience (#64296) 2026-09-25 15:42:49 +00:00
corgi.toml gpui_macos: Migrate screen capture to objc2 (#64251) 2026-09-17 01:46:02 +00:00
default.nix nix: Use flake-parts, partitions, and treefmt-nix (#45321) 2026-02-02 14:26:42 +00:00
Dockerfile-collab Bump Rust to 1.98.1 (#63010) 2026-09-11 09:13:44 +00:00
Dockerfile-collab.dockerignore
Dockerfile-cross.dockerignore Add remote server cross compilation (#19136) 2024-10-12 23:23:56 -07:00
Dockerfile-distros Removal of mold/wild scripts and mentions in docs (#53078) 2026-04-08 21:20:02 +03:00
Dockerfile-distros.dockerignore
flake.lock Update nixpkgs and use its WebRTC package (#65203) 2026-10-05 21:03:45 +00:00
flake.nix ci: Remove garnix substitutor (#58033) 2026-05-29 05:56:42 +00:00
GEMINI.md Add missing GEMINI.md rule file for gemini-cli (#38885) 2025-10-02 09:47:29 -04:00
LICENSE-APACHE Update license year (#24191) 2025-02-04 09:02:59 -05:00
LICENSE-GPL
Procfile Update instructions for local collaboration (#35689) 2025-08-06 11:10:28 -07:00
Procfile.web Remove PostgREST (#41299) 2025-10-27 13:27:59 -04:00
README.md markdown: Restore fallback language highlighting for untagged code blocks (#63023) 2026-08-21 16:00:50 +00:00
rust-toolchain.toml Bump Rust to 1.98.1 (#63010) 2026-09-11 09:13:44 +00:00
rustfmt.toml nix: Use flake-parts, partitions, and treefmt-nix (#45321) 2026-02-02 14:26:42 +00:00
shell.nix nix: Use flake-parts, partitions, and treefmt-nix (#45321) 2026-02-02 14:26:42 +00:00

Zed

Zed CI

Welcome to Zed, a high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.


Installation

On macOS, Linux, and Windows you can download Zed directly or install Zed via your local package manager (macOS/Linux/Windows).

Other platforms are not yet available:

Developing Zed

Contributing

See CONTRIBUTING.md for ways you can contribute to Zed.

Also... we're hiring! Check out our jobs page for open roles.

Licensing

Zed source code is licensed primarily under GPL-3.0-or-later, with Apache-2.0 components where marked.

License information for third party dependencies must be correctly provided for CI to pass.

We use cargo-about to automatically comply with open source licenses. If CI is failing, check the following:

  • Is it showing a no license specified error for a crate you've created? If so, add publish = false under [package] in your crate's Cargo.toml.
  • Is the error failed to satisfy license requirements for a dependency? If so, first determine what license the project has and whether this system is sufficient to comply with this license's requirements. If you're unsure, ask a lawyer. Once you've verified that this system is acceptable add the license's SPDX identifier to the accepted array in script/licenses/zed-licenses.toml.
  • Is cargo-about unable to find the license for a dependency? If so, add a clarification field at the end of script/licenses/zed-licenses.toml, as specified in the cargo-about book.

Sponsorship

Zed is developed by Zed Industries, Inc., a for-profit company.

If you’d like to financially support the project, you can do so via GitHub Sponsors. Sponsorships go directly to Zed Industries and are used as general company revenue. There are no perks or entitlements associated with sponsorship.