Skip to content

Add Spotlight keywords for improved discoverability#3255

Open
richtabor wants to merge 1 commit intotrunkfrom
codex/add-spotlight-keywords
Open

Add Spotlight keywords for improved discoverability#3255
richtabor wants to merge 1 commit intotrunkfrom
codex/add-spotlight-keywords

Conversation

@richtabor
Copy link
Copy Markdown

@richtabor richtabor commented Apr 27, 2026

Related issues

  • Related to user feedback on X that the installed app is hard to find when searching for "WordPress" because the app name is just "Studio".

How AI was used in this PR

Codex was used to inspect the Electron Forge packaging configuration, test how macOS Spotlight reads app bundle metadata, and apply the focused metadata change. The resulting diff was reviewed and validated locally.

Proposed Changes

  • Add macOS MDItemKeywords metadata to the packaged app via Electron Forge packagerConfig.extendInfo. This is scoped to macOS app-bundle metadata and does not change Windows or Linux package metadata.
  • Include WordPress, WordPress Studio, WP, and local WordPress development as Spotlight keywords so the app can be discovered by WordPress-related searches without renaming the app bundle.

Testing Instructions

  1. Build a packaged macOS app:
npm run make:macos-arm64
  1. Replace the installed app with the packaged app, or copy it to /Applications/Studio.app.

  2. Confirm the packaged plist contains the metadata as a comma-separated string:

/usr/libexec/PlistBuddy -c 'Print :MDItemKeywords' /Applications/Studio.app/Contents/Info.plist

Expected output:

WordPress, WordPress Studio, WP, local WordPress development
  1. Force Spotlight to re-import the app bundle and inspect the indexed metadata:
mdimport -i /Applications/Studio.app
mdls -name kMDItemKeywords /Applications/Studio.app

Expected output should include WordPress in kMDItemKeywords.

  1. Verify the app can be found through a WordPress keyword query:
mdfind "kMDItemKeywords == '*WordPress*' && kMDItemContentType == 'com.apple.application-bundle'"

Expected output should include:

/Applications/Studio.app
  1. Optional manual check: open Spotlight and search for WordPress; Studio should be discoverable.

Local validation run on this branch:

npm run typecheck
npx prettier --check apps/studio/forge.config.ts
npx ts-node -e "import config from './apps/studio/forge.config'; const keywords = (config.packagerConfig as any).extendInfo?.MDItemKeywords; if (typeof keywords !== 'string' || !keywords.includes('WordPress')) process.exit(1); console.log(keywords);"

Note: npx eslint --fix apps/studio/forge.config.ts currently fails because apps/studio/forge.config.ts is outside the repo's ESLint TypeScript project service configuration.

Pre-merge Checklist

  • Have you checked for TypeScript, React or other console errors?

@richtabor richtabor changed the title Add Spotlight keywords for WordPress search Add Spotlight keywords for improved discoverability Apr 27, 2026
@richtabor richtabor marked this pull request as ready for review April 27, 2026 12:23
Copilot AI review requested due to automatic review settings April 27, 2026 12:23
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves macOS Spotlight discoverability for the Studio app without renaming the app bundle, by adding keyword metadata to the app’s packaged Info.plist via Electron Forge’s packaging configuration.

Changes:

  • Add packagerConfig.extendInfo.MDItemKeywords to the macOS app bundle metadata.
  • Include WordPress-related terms (WordPress, WordPress Studio, WP, local WordPress development) as Spotlight keywords.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants