Skip to content

macOS: Bundle placeholder Document.icns so Finder can display Zed file icons#44833

Merged
mattermill merged 2 commits intomainfrom
fix/macos-document-icons
Dec 17, 2025
Merged

macOS: Bundle placeholder Document.icns so Finder can display Zed file icons#44833
mattermill merged 2 commits intomainfrom
fix/macos-document-icons

Conversation

@nathansobo
Copy link
Contributor

@nathansobo nathansobo commented Dec 14, 2025

Generated by AI.

DocumentTypes.plist declares CFBundleTypeIconFile as Document for Zed’s document types, but the macOS bundle did not include Contents/Resources/Document.icns, causing Finder to fall back to generic icons.

This PR:

  • Adds crates/zed/resources/Document.icns as a placeholder document icon (currently derived from the app icon).
  • Updates script/bundle-mac to copy it into the .app at Contents/Resources/Document.icns during bundling.
  • Adds script/verify-macos-document-icon for one-command validation.

How to test (CLI)

  1. Build a debug bundle:
    • ./script/bundle-mac -d aarch64-apple-darwin
  2. Verify the bundle contains the referenced icon:
    • ./script/verify-macos-document-icon "target/aarch64-apple-darwin/debug/bundle/osx/Zed Dev.app"

Optional visual validation in Finder

  • Pick a file (e.g. .rs), Get Info → Open with: Zed Dev → Change All...
  • Restart Finder: killall Finder (or log out/in)

@JosephTLyons — would you mind running the steps above and confirming Finder shows Zed’s icon for source files after "Change All" + Finder restart?

@danilo-leal — this PR ships a placeholder Document.icns. When the real document icon is ready, replace crates/zed/resources/Document.icns and the bundling script will include it automatically.

Closes #44403.

Release Notes:

  • TODO

@cla-bot cla-bot bot added the cla-signed The user has signed the Contributor License Agreement label Dec 14, 2025
@zed-industries-bot
Copy link
Contributor

zed-industries-bot commented Dec 14, 2025

Warnings
⚠️
macOS: Bundle placeholder Document.icns so Finder can display Zed file icons
^

Write PR titles using sentence case.

Have feedback on this plugin? Let's hear it!

Generated by 🚫 dangerJS against 46bbaab

@maxdeviant maxdeviant changed the title macOS: bundle placeholder Document.icns so Finder can display Zed file icons macOS: Bundle placeholder Document.icns so Finder can display Zed file icons Dec 14, 2025
@JosephTLyons
Copy link
Collaborator

Works for me!
SCR-20251215-bmsn

@mattermill mattermill merged commit f00cb37 into main Dec 17, 2025
23 checks passed
@mattermill mattermill deleted the fix/macos-document-icons branch December 17, 2025 22:42
rtfeldman pushed a commit that referenced this pull request Jan 5, 2026
…e icons (#44833)

Generated by AI.

`DocumentTypes.plist` declares `CFBundleTypeIconFile` as `Document` for
Zed’s document types, but the macOS bundle did not include
`Contents/Resources/Document.icns`, causing Finder to fall back to
generic icons.

This PR:
- Adds `crates/zed/resources/Document.icns` as a placeholder document
icon (currently derived from the app icon).
- Updates `script/bundle-mac` to copy it into the `.app` at
`Contents/Resources/Document.icns` during bundling.
- Adds `script/verify-macos-document-icon` for one-command validation.

## How to test (CLI)
1. Build a debug bundle:
   - `./script/bundle-mac -d aarch64-apple-darwin`
2. Verify the bundle contains the referenced icon:
- `./script/verify-macos-document-icon
"target/aarch64-apple-darwin/debug/bundle/osx/Zed Dev.app"`

## Optional visual validation in Finder
- Pick a file (e.g. `.rs`), Get Info → Open with: Zed Dev → Change
All...
- Restart Finder: `killall Finder` (or log out/in)

@JosephTLyons — would you mind running the steps above and confirming
Finder shows Zed’s icon for source files after "Change All" + Finder
restart?

@danilo-leal — this PR ships a placeholder `Document.icns`. When the
real document icon is ready, replace
`crates/zed/resources/Document.icns` and the bundling script will
include it automatically.


Closes #44403.

Release Notes:

- TODO

---------

Co-authored-by: Matt Miller <mattrx@gmail.com>
LivioGama pushed a commit to LivioGama/zed that referenced this pull request Jan 20, 2026
…e icons (zed-industries#44833)

Generated by AI.

`DocumentTypes.plist` declares `CFBundleTypeIconFile` as `Document` for
Zed’s document types, but the macOS bundle did not include
`Contents/Resources/Document.icns`, causing Finder to fall back to
generic icons.

This PR:
- Adds `crates/zed/resources/Document.icns` as a placeholder document
icon (currently derived from the app icon).
- Updates `script/bundle-mac` to copy it into the `.app` at
`Contents/Resources/Document.icns` during bundling.
- Adds `script/verify-macos-document-icon` for one-command validation.

## How to test (CLI)
1. Build a debug bundle:
   - `./script/bundle-mac -d aarch64-apple-darwin`
2. Verify the bundle contains the referenced icon:
- `./script/verify-macos-document-icon
"target/aarch64-apple-darwin/debug/bundle/osx/Zed Dev.app"`

## Optional visual validation in Finder
- Pick a file (e.g. `.rs`), Get Info → Open with: Zed Dev → Change
All...
- Restart Finder: `killall Finder` (or log out/in)

@JosephTLyons — would you mind running the steps above and confirming
Finder shows Zed’s icon for source files after "Change All" + Finder
restart?

@danilo-leal — this PR ships a placeholder `Document.icns`. When the
real document icon is ready, replace
`crates/zed/resources/Document.icns` and the bundling script will
include it automatically.


Closes zed-industries#44403.

Release Notes:

- TODO

---------

Co-authored-by: Matt Miller <mattrx@gmail.com>
LivioGama pushed a commit to LivioGama/zed that referenced this pull request Jan 20, 2026
…e icons (zed-industries#44833)

Generated by AI.

`DocumentTypes.plist` declares `CFBundleTypeIconFile` as `Document` for
Zed’s document types, but the macOS bundle did not include
`Contents/Resources/Document.icns`, causing Finder to fall back to
generic icons.

This PR:
- Adds `crates/zed/resources/Document.icns` as a placeholder document
icon (currently derived from the app icon).
- Updates `script/bundle-mac` to copy it into the `.app` at
`Contents/Resources/Document.icns` during bundling.
- Adds `script/verify-macos-document-icon` for one-command validation.

## How to test (CLI)
1. Build a debug bundle:
   - `./script/bundle-mac -d aarch64-apple-darwin`
2. Verify the bundle contains the referenced icon:
- `./script/verify-macos-document-icon
"target/aarch64-apple-darwin/debug/bundle/osx/Zed Dev.app"`

## Optional visual validation in Finder
- Pick a file (e.g. `.rs`), Get Info → Open with: Zed Dev → Change
All...
- Restart Finder: `killall Finder` (or log out/in)

@JosephTLyons — would you mind running the steps above and confirming
Finder shows Zed’s icon for source files after "Change All" + Finder
restart?

@danilo-leal — this PR ships a placeholder `Document.icns`. When the
real document icon is ready, replace
`crates/zed/resources/Document.icns` and the bundling script will
include it automatically.


Closes zed-industries#44403.

Release Notes:

- TODO

---------

Co-authored-by: Matt Miller <mattrx@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed The user has signed the Contributor License Agreement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CFBundleTypeIconFile references missing .icns file → Finder cannot display Zed file icons

4 participants