Skip to content

Commit d3c3208

Browse files
committed
Introduce new modern icon pack style guide
This folder will be an entry point for interested users that want to contribute to the modern icon pack for eclipse icons. In the future a welcome page and a tutorial on how to contribute should be added.
1 parent 0873157 commit d3c3208

File tree

1 file changed

+113
-0
lines changed

1 file changed

+113
-0
lines changed

eclipse-modern-icon-pack/README.md

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
## Eclipse Modern Icon Pack Style Guide
2+
This style guide serves as an orientation for designing icons in the modern Eclipse icon pack. Its primary goal is to ensure visual consistency across all icons so they appear as part of a cohesive design system. The rules outlined here provide a solid foundation for icon creation and help maintain a unified look and feel.
3+
4+
However, visual harmony sometimes requires flexibility. In certain cases, it may be necessary to bend the rules slightly to achieve the best visual result for a specific icon. This guide is not a rigid set of constraints, but a framework that can evolve over time. It may be refined as new needs emerge or design patterns shift.
5+
6+
In addition to the rules described in this document, it is equally important to take inspiration from existing icons in the modern icon pack. These existing designs offer valuable guidance and can help ensure new icons align with the established style.
7+
8+
### **Icon Types**
9+
Every Icon is categorized into one of three distinct types:
10+
11+
1. **Base Icons (Gray Scale)**
12+
- Most icons are colored in a standard gray tone, ensuring a neutral and consistent appearance.
13+
- The gray tone differs from light mode to dark mode.
14+
15+
![Image](https://github.com/user-attachments/assets/f87ca5fb-eb5a-4dc2-b59c-8393211222aa)
16+
17+
2. **Monochromatic Colored Icons**
18+
- Used for important actions such as "Run" (green) or "Stop" (red).
19+
- These icons employ a single, distinct color to indicate their function clearly.
20+
21+
![Image](https://github.com/user-attachments/assets/787c7756-7bfb-481a-88d6-baed6200842d)
22+
23+
3. **Dual-Tone Icons**
24+
- A hybrid of the base and monochromatic styles.
25+
- The main part of the icon remains in base gray, while a key element (e.g., the "pin" in a "Pin Editor" icon) is highlighted in a single distinct accent color.
26+
27+
![Image](https://github.com/user-attachments/assets/8f77772f-c1c5-46be-89b7-0b232be29bed)
28+
29+
---
30+
31+
### **Color Assignments**
32+
Each color has a specific meaning and should be applied consistently:
33+
34+
| Color | Purpose | Light Mode | Dark Mode |
35+
|-------------|--------------------------------------------------|------------------|------------------|
36+
| **Gray** | Default color for all icons | `#6E6E6E` | `#A8A8A8` |
37+
| **Green** | Indicates action (e.g., "Run") | `#008000` | Same |
38+
| **Red** | Error, alert, or stop (e.g., "Stop") | `#C80000` | Same |
39+
| **Yellow** | Warnings | `#FFD700` | Same |
40+
| **Purple** | For "Web Site," "Fragment," "Interface," etc. | `#800080` | Same |
41+
42+
For the color of the key-element of dual-toned icons see the color table in section **Specifications**.
43+
For the color of Overlay icons also see the color table in section **Specifications**.
44+
45+
---
46+
47+
### **Icon Sizes & Placement**
48+
49+
- The icon’s motive must be centered within the view area.
50+
- The design should fully utilize the available space while maintaining balance and clarity.
51+
- If full width and height cannot be used simultaneously, at least one of them should be fully utilized.
52+
53+
<img src="https://github.com/user-attachments/assets/e69066c1-d21c-492c-b1c4-7ec3d073e5ef" width="200"/>
54+
55+
### **Standard Icons**
56+
- View area: **16x16 pixels**
57+
58+
### **Overlay Icons**
59+
- View area: **8x7 pixels**
60+
- Overlay icons must be **monochromatic colored** to ensure they remain distinguishable from the base icon.
61+
- The color of Overlay icons should be chosen from the table in the section **Specifications**.
62+
63+
### **Wizard Icons**
64+
- Standard size: **75x58 pixels**
65+
66+
---
67+
68+
### **Disabled Icon State**
69+
Disabled icons should maintain their original form while visually indicating inactivity:
70+
71+
- **Light Mode:** Icons become brighter
72+
- **Dark Mode:** Icons become darker
73+
- **Transparency Adjustment:**
74+
- The disabled state is achieved programmatically by modifying transparency.
75+
- Colored icons retain a faint version of their original hue to preserve recognition while ensuring they appear deactivated.
76+
77+
---
78+
79+
### **Specifications**
80+
81+
This section outlines the design rules for Eclipse icons in the modern icon pack.
82+
83+
**Stroke style**
84+
- Every path/stroke must have a fixed width of 2.0 px to ensure visibility at small sizes.
85+
- All strokes must have rounded corners for a smooth appearance.
86+
87+
**Spacing**
88+
- Spacing between elements within an icon is allowed but should always be 1.5 px wide.
89+
90+
**Corners**
91+
- The corners of each stroke and shape should be rounded with a radius of 1.0px.
92+
93+
**Dual-Tonality**
94+
- The spacing between the main part and the key element must be 1.5 px wide.
95+
- The key element itself must have a width AND/OR a height of 10.0 px.
96+
- The key element should be placed in the top or bottom right corner of the view area, if it has an clickable/action purpose.
97+
98+
<img src="https://github.com/user-attachments/assets/7cade825-786e-4a7e-9464-36a449c712b1" width="200"/>
99+
100+
- The key element should be placed in the top or bottom left corner of the view area, if it has an informational purpose. The following example shows an icon for the type of a breakpoint:
101+
102+
<img src="https://github.com/user-attachments/assets/36577223-a103-4136-841d-ada7f2550ec1" width="200"/>
103+
104+
- The color of the key element or Overlay icon can be chosen from the following table:
105+
106+
| Color | Purpose | Light Mode | Dark Mode |
107+
|-------------|--------------------------------------------------|------------------|------------------|
108+
| **Green** | Indicates action (e.g., "Run") | `#008000` | Same |
109+
| **Red** | Error, alert, or stop (e.g., "Stop") | `#C80000` | Same |
110+
| **Yellow** | Warnings | `#FFD700` | Same |
111+
| **Blue** | General Information | `#0065C7` | Same |
112+
113+

0 commit comments

Comments
 (0)