jetbrains-theme-investigation
Investigates JetBrains IntelliJ Platform theme properties by searching source code. Use when user asks about UI theming, icon colors, tab spacing, component styling, or needs to find what properties are themeable vs hardcoded in IntelliJ-based IDEs.
When & Why to Use This Skill
The JetBrains Theme Investigation skill empowers developers to explore and analyze theme properties within the IntelliJ Platform source code. By automating the search through metadata JSONs and Java/Kotlin source files, it clarifies whether UI elements—such as icon colors, tab spacing, and component styling—are themeable via JSON or hardcoded, significantly accelerating the theme development and customization workflow.
Use Cases
- Identifying themeable properties: Quickly determine if a specific UI element's attribute (e.g., background color, border thickness) can be customized through a theme JSON file.
- Source code auditing: Search the IntelliJ community source code to find where specific 'namedColor' or 'JBUI' methods are invoked to understand programmatic styling.
- Icon color mapping: Investigate SVG icon metadata and color palettes to ensure consistent branding across custom IntelliJ-based IDE distributions.
- Differentiating hardcoded vs. customizable UI: Verify if a UI component requires a platform-level code change or if it can be styled using existing theme keys.
| name | jetbrains-theme-investigation |
|---|---|
| description | Investigates JetBrains IntelliJ Platform theme properties by searching source code. Use when user asks about UI theming, icon colors, tab spacing, component styling, or needs to find what properties are themeable vs hardcoded in IntelliJ-based IDEs. |
JetBrains Theme Investigation
Investigate theme properties in the IntelliJ Platform source code to determine what is themeable via JSON vs hardcoded in source.
Prerequisites
IntelliJ Platform source code must be available at:
../../JetBrains/intellij-community
(Relative to current project directory)
If not cloned yet:
cd ~/Projects/github.com/JetBrains
git clone https://github.com/JetBrains/intellij-community
Quick Investigation Workflow
Search theme metadata first (what properties exist):
grep -i "PropertyName" ../../JetBrains/intellij-community/platform/platform-resources/src/themes/metadata/*.jsonCheck reference themes (how properties are used):
grep -r "PropertyName" ../../JetBrains/intellij-community/platform/platform-resources/src/themes/ --include="*.json"Search JBUI.java for programmatic color access:
grep -A3 "namedColor.*PropertyName" ../../JetBrains/intellij-community/platform/util/ui/src/com/intellij/util/ui/JBUI.javaSearch source for hardcoded values if not found above:
grep -rn "propertyName\|PROPERTY_NAME" ../../JetBrains/intellij-community/platform/platform-*/src --include="*.kt" --include="*.java"
Key Directories
| Path | Content |
|---|---|
platform/platform-resources/src/themes/metadata/ |
Available theme properties (IntelliJPlatform.themeMetadata.json, JDK.themeMetadata.json) |
platform/platform-resources/src/themes/ |
Reference themes (expUI, islands, darcula, HighContrast) |
platform/util/ui/src/com/intellij/util/ui/JBUI.java |
CurrentTheme methods mapping to JSON keys |
platform/icons/src/ |
SVG icons (check colors used) |
Detailed References
For specific subsystems, see:
- Icon colors: icon-colors.md - ColorPalette, stroke colors, named keys
- Tab system: tab-system.md - Tab gaps, insets, layouts
- Islands theme: islands-theme.md - Islands-specific properties
- Known limitations: limitations.md - What is NOT themeable
- Theme testing panel: theme-testing-panel.md - Dev-mode UI testing panel
Determining if Themeable
| Found In | Result |
|---|---|
| Theme metadata JSON | Themeable via JSON |
JBUI.java with namedColor/getInt |
Themeable via JSON |
| Source code with hardcoded values | NOT themeable (requires code change) |