Material Icons for GitHub

Install directly from the Chrome Web Store | Microsoft Edge Addons Store | Firefox Addons | Safari (build from source)

---

About

Material Icons for GitHub is a browser Extension that enhances repositories file browsers when navigating github.com. Replace default file/folder icons with material design icons tailored to each file type, tool and purpose in the project.

Based and dependent on the popular Material Icon Theme extension for Visual Studio Code. All icons and file assignments on this project are pulled directly from that project, so any praise or design issues should be raised on the original repository.

Safari (macOS)

There is no App Store release yet, but you can build and install it yourself with Xcode, Node.js 24.15+ and a free Apple account.

1. Build the extension and generate the Xcode project:

   npm install
   npm run package-safari

2. Open out/safari/Material Icons for GitHub/Material Icons for GitHub.xcodeproj in Xcode.

3. Add your Apple ID in Xcode → Settings → Accounts, then under Signing & Capabilities set Team to your Personal Team for the macOS app and macOS extension targets.

4. Select the Material Icons for GitHub (macOS) scheme and run it (⌘R). Move the built app to /Applications so the extension stays installed.

5. In Safari → Settings → Extensions, enable Material Icons for GitHub and allow it on github.com.

If the extension doesn't appear, enable Settings → Advanced → Show features for web developers, then Settings → Developer → Allow unsigned extensions. The iOS targets are generated too but untested.

Safari applies the page's Content Security Policy to extension URLs, so on Safari the icons are loaded as data: URLs through the background script.

Build locally

npm run build

Development

Build only files from src folder, without re-downloading dependencies from Material Icon Theme

npm run build-src

Rebuild extension logos from src/logo.svg. Only needed when src/logo.svg is changed.

npm run rebuild-logos

Zip dist folder for upload to Chrome Web Store and Firefox. This script needs Zip to be available on PATH

npm run bundle

Build a Safari Web Extension bundle in dist/safari:

npm run build-src

Package the Safari bundle into an Xcode project for local Safari testing or App Store distribution. This requires Xcode with safari-web-extension-packager available on PATH.

npm run package-safari

---

Original extension developed with Richard Lam