Makinda Icons

Multi-style icon themes for VS Code and the wider VS Code family — inspired by Hugeicons, tuned for the Makinda brand.

Install • Activate • Pair with Makinda Themes • Troubleshooting • License

This extension ships two independent themes you can mix and match:

• Makinda Icons (Solid) — file & folder icons in the Explorer, tabs, breadcrumbs, Quick Open.
• Makinda Product Icons (Solid) — UI icons in the Activity Bar, status bar, gutters, and panels (84 codicon overrides).

Iconography inspired by Hugeicons. Currently shipping the Solid style. Duotone, Twotone, Stroke, Bulk, and Sharp variants are on the roadmap.

Install

Pick the section that matches your editor.

Visual Studio Code · VS Code Insiders · GitHub Codespaces

From the Marketplace UI

1. Open Extensions (Cmd/Ctrl + Shift + X).
2. Search for Makinda Icons.
3. Click Install.

From the command line

# Stable
code --install-extension makindajack.makinda-icons

# Insiders
code-insiders --install-extension makindajack.makinda-icons

In Codespaces and vscode.dev / github.dev, install the same way as desktop VS Code — search and install from the in-browser Extensions view.

Cursor

1. Open Extensions in the sidebar.
2. Search for Makinda Icons.
3. Click Install. (Cursor pulls from Open VSX; the listing is mirrored automatically.)

CLI alternative:

cursor --install-extension makindajack.makinda-icons

Windsurf (Codeium)

1. Open the Extensions view.
2. Search for Makinda Icons and install.

CLI:

windsurf --install-extension makindajack.makinda-icons

Trae (ByteDance)

1. Open Extensions.
2. Search for Makinda Icons and install.

If your build of Trae can't reach the registry, use the manual install below.

VSCodium

VSCodium uses the Open VSX Registry, not the VS Code Marketplace.

1. Open Extensions, search for Makinda Icons, install.
2. Or from the CLI:

codium --install-extension makindajack.makinda-icons

Gitpod · code-server · Eclipse Theia

These editors also use Open VSX. Install via the in-app Extensions view, or:

# code-server
code-server --install-extension makindajack.makinda-icons

If your code-server instance points at a different gallery, set:

export EXTENSIONS_GALLERY='{"serviceUrl":"https://open-vsx.org/vscode/gallery","itemUrl":"https://open-vsx.org/vscode/item"}'

before launching it.

Manual install (any compatible editor)

If a registry isn't reachable, every editor listed above accepts a local .vsix:

1. Download makinda-icons-<version>.vsix from the GitHub Releases page.
2. In your editor: Extensions view → … menu → Install from VSIX… → pick the file.
3. Reload if prompted.

CLI alternative — works for VS Code, VSCodium, Cursor, Windsurf, Trae, code-server:

<editor-cli> --install-extension /path/to/makinda-icons-<version>.vsix

Not yet supported

JetBrains IDEs, Sublime Text, Neovim, Emacs, Xcode, Visual Studio (Windows), Fleet, and Zed don't implement the VS Code icon-theme format. Separate ports are tracked in the roadmap.

Activate

Once installed, switch each theme independently. They're separate settings — you can use one without the other.

File icons

1. Open the Command Palette: Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows / Linux).
2. Run Preferences: File Icon Theme.
3. Select Makinda Icons (Solid).

Or set it directly in settings.json:

{
  "workbench.iconTheme": "makinda-file-icons-solid",
}

Product icons (UI icons)

1. Command Palette → Preferences: Product Icon Theme.
2. Select Makinda Product Icons (Solid).

Or in settings.json:

{
  "workbench.productIconTheme": "makinda-product-icons-solid",
}

Use both at once

{
  "workbench.iconTheme": "makinda-file-icons-solid",
  "workbench.productIconTheme": "makinda-product-icons-solid",
}

Pair with Makinda Themes

These icons are color-tuned to match the Makinda Themes color set:

{
  "workbench.colorTheme": "Makinda Dark",
  "workbench.iconTheme": "makinda-file-icons-solid",
  "workbench.productIconTheme": "makinda-product-icons-solid",
}

Auto-switch with your OS appearance:

{
  "window.autoDetectColorScheme": true,
  "workbench.preferredLightColorTheme": "Makinda Light",
  "workbench.preferredDarkColorTheme": "Makinda Dark",
  "workbench.iconTheme": "makinda-file-icons-solid",
  "workbench.productIconTheme": "makinda-product-icons-solid",
}

Troubleshooting

Icons didn't change after installing. Run Preferences: File Icon Theme and Preferences: Product Icon Theme explicitly — installation alone doesn't activate either.

A specific file type still uses the default icon. That extension isn't in the starter set yet. Open an issue with the extension name and I'll add it.

Some UI icons (gutter, status bar) are unchanged. Product Icon Themes can only override icons whose codicon ID is mapped. Anything not yet in the manifest falls back to the built-in codicon — that's by design, not a bug. The list of overrides will grow.

Cursor / Windsurf / Trae can't find it. Their bundled Open VSX index sometimes lags. Fall back to the manual .vsix install.

Links

• GitHub repository
• Report an issue
• Roadmap
• Contributing & build docs
• Companion color theme: Makinda Themes

License

See LICENSE.md. Icon assets are derived from Hugeicons Pro and are not redistributable without your own Hugeicons license.