Emoji Tags VS Code Extension

Tag any keyword with an emoji. Personalize your classes, methods, types, and any keyword for visual clarity and style!

Features

• Map any word to any emoji (Unicode supported)
• Global and local mappings (local overrides global)
• Modern tree view UI for managing mappings and file patterns
• Inline toolbar: refresh, toggle duplicate handling, toggle emoji position
• Smart add mapping: pre-fills from selection, supports any order/spacing, removes emoji from selection
• File include/exclude patterns (global/local, managed in UI)
• Robust emoji detection (emoji-regex)
• No code changes—decorations only

Quick Start

1. Install and reload the extension in VS Code.
2. Open the Emoji Names view from the Activity Bar.
3. Use the tree view and commands below to manage your mappings.

Commands (Ctrl+Shift+P)

Most Frequent

• Add Local Emoji Mapping: Add a word→emoji mapping to the current workspace.
  • Select text or place cursor, run command, enter word and emoji (any order).
• Add Global Emoji Mapping: Add a mapping to all projects.
• Remove Mapping: Right-click a mapping in the tree view or run the command.

Display & Behavior

• Toggle Emoji Position: Switch emoji to left/right of word.
• Toggle Duplicate Handling: Cycle between first-only, second-only, both for consecutive word matches.
• Refresh Emoji Decorations: Refresh all emoji overlays. (Optional)

File Patterns

• Add/Remove/Reset Include/Exclude Patterns: Manage which files are decorated (global/local, include/exclude) via the tree view.
  • Note: By default, includeFiles is empty (all files included). excludeFiles is empty (no exclusions). Exclusion always takes priority.

Settings

{
  "emojiNames.enabled": true,
  "emojiNames.position": "right",
  "emojiNames.duplicateHandling": "first-only",
  "emojiNames.mappings": { "User": "👤" },
  "emojiNames.includeFiles": [], // empty = all files
  "emojiNames.excludeFiles": []  // empty = no exclusions
}

• Global settings: User settings (apply everywhere)
• Local settings: Workspace settings (override global)

Examples

// Mapping: User → 👤
class User { /* ... */ } // User👤

// Duplicate handling
User User User // first-only: User👤 User User
// second-only: User User👤 User
// both: User👤 User👤 User👤

How It Works

• Uses VS Code's decoration API—no code changes, no syntax issues
• Works with any file type
• All text functionality (search, replace, etc.) is preserved

Development

• npm install — install dependencies
• npm run compile — build the extension
• F5 in VS Code — launch Extension Development Host
• If anything is not working as intended, please provide error logs from console (Help > Toggle Developer Tools)

License

MIT License