Skip to content

Commit 44b627b

Browse files
authored
Update style-guide.md
1 parent 82642fd commit 44b627b

File tree

1 file changed

+22
-4
lines changed

1 file changed

+22
-4
lines changed

docs/style-guide.md

+22-4
Original file line numberDiff line numberDiff line change
@@ -16,19 +16,37 @@ The core blue family serves as the primary action color across all IBM products
1616

1717
As a general guideline, the two most used colors should be *pink* and *cyan*, with darker blues and subdued pinks/purples used for important but not notable text. You may also use bolding and italicizing as a tool to emphasize important text such as function declartions or comments
1818

19-
## Guideline
19+
## Guidelines
2020

21-
Your most used references are going to be the IBM branding color guidelines (<https://www.ibm.com/brand/experience-guides/developer/brand/color>) and the carbon design systems color guidelines (<https://carbondesignsystem.com/guidelines/color/overview/>). The most notable guidelines to keep in mind are
21+
Your most used references are going to be the IBM branding color guidelines (https://www.ibm.com/design/language/color/) and the carbon design systems color guidelines (https://carbondesignsystem.com/guidelines/color/overview/). The most notable guidelines to keep in mind are
2222

2323
Backgrounds/Foregrounds:
2424

2525
- Background colors follow a layering model. The darkest black (base00) should always be the background color, and any UI elements should always use a lighter tone of black (e.g. base01 or base02).
26-
2726
- Foreground colors follow a similar model, except that instead of getting lighter and lighter, you may alternate between the lightest color in the theme (base06) and the second/third lighest (base05, base04)
2827

28+
<img width="823" alt="image" src="https://user-images.githubusercontent.com/71196912/206875348-b3f24d9a-81c1-49f9-bbb4-f4e3f65dbdec.png">
29+
2930
- For readability reasons, do not apply components that are darker than the background, except in special cases
3031

32+
<img width="863" alt="image" src="https://user-images.githubusercontent.com/71196912/206875206-b59a413d-82cb-4fc1-9091-7d90f0c4cddd.png">
33+
3134
- Its important to maintain proper contrast at all times. Based off of the <https://www.w3.org/TR/WCAG21/>, small text is any size below 24px and requires a 4.5:1 contrast ratio. Large text is anything above 24px and requires a 3:1 contrast ratio. Graphical elements, such as data visualizations, also require a 3:1 contrast ratio. The IBM palette is comprised of twelve color grades—Black, White and ten values for each hue. The following table indicates the minimum number of steps required to achieve commonly used contrast ratios between any two colors.
3235

36+
<img width="548" alt="image" src="https://user-images.githubusercontent.com/71196912/206875056-77d3aafd-8323-4e08-90da-2c725e42a8b1.png">
37+
38+
<img width="963" alt="image" src="https://user-images.githubusercontent.com/71196912/206875119-73543502-0094-495e-a7b6-0584b7dae2bf.png">
39+
40+
3341
Code/Colors
34-
-
42+
- Respect the 4/3/2 color sets that IBM has created.
43+
<img width="590" alt="image" src="https://user-images.githubusercontent.com/71196912/206875287-143e1806-6615-4cee-868e-db20e61df6b0.png">
44+
<img width="588" alt="image" src="https://user-images.githubusercontent.com/71196912/206875293-0e28f70a-4cef-4170-82b1-52b4bda6d5fc.png">
45+
<img width="588" alt="image" src="https://user-images.githubusercontent.com/71196912/206875298-429a467c-b04d-47f5-9574-2eeacca9ab83.png">
46+
47+
- Avoid mixing greens with reds, magentas or purples.
48+
- Avoid mixing teals with reds or magentas.
49+
50+
<img width="652" alt="image" src="https://user-images.githubusercontent.com/71196912/206875306-332faebb-d0b8-48e7-99e7-8e55b04987fc.png">
51+
52+
- Avoid using gradients

0 commit comments

Comments
 (0)