@czi-sds/mcp 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/data/zeroheight-cache.json +5195 -0
  2. package/data/zeroheight-exports/Accordion.md +675 -0
  3. package/data/zeroheight-exports/Banner.md +576 -0
  4. package/data/zeroheight-exports/Borders.md +118 -0
  5. package/data/zeroheight-exports/Buttons.md +2260 -0
  6. package/data/zeroheight-exports/Callout.md +756 -0
  7. package/data/zeroheight-exports/Colors.md +633 -0
  8. package/data/zeroheight-exports/Content-Card.md +162 -0
  9. package/data/zeroheight-exports/Contributing-to-SDS.md +99 -0
  10. package/data/zeroheight-exports/Control-Inputs.md +2066 -0
  11. package/data/zeroheight-exports/Corners.md +112 -0
  12. package/data/zeroheight-exports/Cover-page.md +4 -0
  13. package/data/zeroheight-exports/Dialog.md +1133 -0
  14. package/data/zeroheight-exports/Downloads.md +121 -0
  15. package/data/zeroheight-exports/Drop-Shadows.md +80 -0
  16. package/data/zeroheight-exports/Dropdown-Input.md +1149 -0
  17. package/data/zeroheight-exports/Dropdown-Menu.md +3787 -0
  18. package/data/zeroheight-exports/Element-Status-Tracker.md +268 -0
  19. package/data/zeroheight-exports/Field-Inputs.md +965 -0
  20. package/data/zeroheight-exports/Filters.md +868 -0
  21. package/data/zeroheight-exports/Getting-Started.md +1296 -0
  22. package/data/zeroheight-exports/Hero.md +256 -0
  23. package/data/zeroheight-exports/Icons.md +432 -0
  24. package/data/zeroheight-exports/Intent.md +47 -0
  25. package/data/zeroheight-exports/Introduction-to-Bases.md +36 -0
  26. package/data/zeroheight-exports/Introduction-to-Cells.md +36 -0
  27. package/data/zeroheight-exports/Introduction-to-DNA.md +36 -0
  28. package/data/zeroheight-exports/Introduction-to-Genes.md +36 -0
  29. package/data/zeroheight-exports/Introduction.md +116 -0
  30. package/data/zeroheight-exports/Link.md +373 -0
  31. package/data/zeroheight-exports/Lists.md +617 -0
  32. package/data/zeroheight-exports/Loading-Indicator.md +38 -0
  33. package/data/zeroheight-exports/Navigation.md +853 -0
  34. package/data/zeroheight-exports/Notification.md +858 -0
  35. package/data/zeroheight-exports/Panel.md +862 -0
  36. package/data/zeroheight-exports/README.md +124 -0
  37. package/data/zeroheight-exports/Responsive-Design.md +275 -0
  38. package/data/zeroheight-exports/Search-Input.md +54 -0
  39. package/data/zeroheight-exports/Search.md +609 -0
  40. package/data/zeroheight-exports/Segmented-Control.md +561 -0
  41. package/data/zeroheight-exports/Spacing.md +298 -0
  42. package/data/zeroheight-exports/Table.md +4832 -0
  43. package/data/zeroheight-exports/Tabs.md +773 -0
  44. package/data/zeroheight-exports/Tags.md +1025 -0
  45. package/data/zeroheight-exports/Text-Link.md +185 -0
  46. package/data/zeroheight-exports/Theming.md +313 -0
  47. package/data/zeroheight-exports/Tooltips.md +1564 -0
  48. package/data/zeroheight-exports/Typography.md +769 -0
  49. package/dist/stdio.js +515 -12
  50. package/package.json +4 -3
@@ -0,0 +1,633 @@
1
+ # Colors
2
+
3
+ Color helps communicate usage and intent while providing brand distinction. The SDS palette has been selected for meaning, accessibility, and cohesion.
4
+
5
+ ## Semantic Colors
6
+
7
+ ## Color Overview
8
+
9
+ SDS uses a pragmatic naming system for its color variables that ensures consistency around how colors are used across UI elements. Colors are split into three types—Primitive, Semantic, and Visualization—and two modes—Light and Dark (Visualization Colors are currently only available in Light Mode); see Theming for more details about implementing Dark Mode.
10
+
11
+ Primitive Colors are base variables that tie directly to hex codes whereas Semantic Colors take these Primitive Color variables and map them to new variables that are specific to UI elements, intents, and states. Visualization Colormaps are specifically for use in data visualizations.
12
+
13
+ ## Semantic Colors
14
+
15
+ While Primitive Color variables define the individual colors within the design system, Semantic Color variables define how those colors are used throughout it. Each element in the design system that can have color applied to it, whether a border, a background, a piece of text, etc., is built using Semantic Color variables.
16
+
17
+ Semantic Color variables are named in such a way as to create predictable usage across SDS. They start with the variable group, followed by the element it is applied to, and then add any number of modifiers to communicate the color's specific application within the UI, such as prominence or state.
18
+
19
+ Because Semantic Color variables are scoped to individual UI elements, a single Primitive Color variable, such as *blue500* (Light Mode) or *blue600* (Dark Mode), can be mapped to a range of Semantic Color variables like *Accent.border*, *Accent.ornament*, *Accent.text-action*, etc. since all of these elements are the same color.
20
+
21
+ | Light Mode | Dark Mode |
22
+ | :---: | :---: |
23
+
24
+ ### Semantic Color Variable Groups
25
+
26
+ ---
27
+
28
+ ### Base Colors
29
+
30
+ #### Background and Surface
31
+
32
+ Base Surface and Background colors create dimension, hierarchy, and separation between content.
33
+
34
+ *Background-primary* is used for the empty space that a page's content is placed upon (i.e., the page's main or base-level background). *Background-secondary* and *background-tertiary* are used when additional hierarchy is needed within one layer.
35
+
36
+ Always implement the Background Colors in order, such that *background-secondary* is layered on top of *background-primary* and *background-tertiary* is layered on top of *background-secondary*; never layer *background-tertiary* directly on top of *background-primary*.
37
+
38
+ Use *surface* for elements that are placed at a higher elevation than the page's main content such as the case with Dropdown Menu or Dialog.
39
+
40
+ When greater visual contrast is needed use *background-primary-inverse, background-secondary-inverse,* and *surface-inverse*.
41
+
42
+ | Light Mode | Dark Mode |
43
+ | :---: | :---: |
44
+
45
+ | Name | | Figma Variable | | CSS / SCSS Variables |
46
+ | --- | --- | --- | --- | --- |
47
+ | background-primary | | Light: Base.background-primary (#ffffff) Dark: Base.background-primary (#101010) | | CSS light / dark: `--sds-color-semantic-component-base-background-primary` SCSS light: `$sds-color-semantic-component-base-background-primary` SCSS dark: `$sds-color-semantic-component-base-background-primary-dark` |
48
+ | background-secondary | | Light: Base.background-secondary (#f8f8f8) Dark: Base.background-secondary (#333333) | | CSS light / dark: `--sds-color-semantic-component-base-background-secondary` SCSS light: `$sds-color-semantic-component-base-background-secondary` SCSS dark: `$sds-color-semantic-component-base-background-secondary-dark` |
49
+ | background-tertiary | | Light: Base.background-tertiary (#ededed) Dark: Base.background-tertiary (#494949) | | CSS light / dark: `--sds-color-semantic-component-base-background-tertiary` SCSS light: `$sds-color-semantic-component-base-background-tertiary` SCSS dark: `$sds-color-semantic-component-base-background-tertiary-dark` |
50
+ | background-primary-inverse | | Light: Base.background-primary-inverse (#000000) Dark: Base.background-primary-inverse (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-background-primary-inverse` SCSS light: `$sds-color-semantic-component-base-background-primary-inverse` SCSS dark: `$sds-color-semantic-component-base-background-primary-inverse-dark` |
51
+ | background-secondary-inverse | | Light: Base.background-secondary-inverse (#3b3b3b) Dark: Base.background-secondary-inverse (#ededed) | | CSS light / dark: `--sds-color-semantic-component-base-background-secondary-inverse` SCSS light: `$sds-color-semantic-component-base-background-secondary-inverse` SCSS dark: `$sds-color-semantic-component-base-background-secondary-inverse-dark` |
52
+ | surface | | Light: Base.surface (#ffffff) Dark: Base.surface (#333333) | | CSS light / dark: `--sds-color-semantic-component-base-surface` SCSS light: `$sds-color-semantic-component-base-surface` SCSS dark: `$sds-color-semantic-component-base-surface-dark` |
53
+ | surface-inverse | | Light: Base.surface-inverse (#000000) Dark: Base.surface-inverse (#ededed) | | CSS light / dark: `--sds-color-semantic-component-base-surface-inverse` SCSS light: `$sds-color-semantic-component-base-surface-inverse` SCSS dark: `$sds-color-semantic-component-base-surface-inverse-dark` |
54
+
55
+ #### Fill
56
+
57
+ Base Fill colors are used for element backgrounds that are interactive and change in response to users hovering, pressing, etc.
58
+
59
+ | Light Mode | Dark Mode |
60
+ | :---: | :---: |
61
+
62
+ | Name | | Figma Variable | | CSS / SCSS Variable |
63
+ | --- | --- | --- | --- | --- |
64
+ | fill-primary | | Light: Base.fill-primary (#ffffff) Dark: Base.fill-primary (#333333) | | CSS light / dark: `--sds-color-semantic-component-base-fill-primary` SCSS light: `$sds-color-semantic-component-base-fill-primary` SCSS dark: `$sds-color-semantic-component-base-fill-primary-dark` |
65
+ | fill-hover | | Light: Base.fill-hover (rgba(195, 195, 195, 0.2800)) Dark: Base.fill-hover (rgba(105, 105, 105, 0.2800)) | | CSS light / dark: `--sds-color-semantic-component-base-fill-hover` SCSS light: `$sds-color-semantic-component-base-fill-hover` SCSS dark: `$sds-color-semantic-component-base-fill-hover-dark` |
66
+ | fill-pressed | | Light: Base.fill-pressed (rgba(195, 195, 195, 0.2800)) Dark: Base.fill-pressed (rgba(105, 105, 105, 0.2800)) | | CSS light / dark: `--sds-color-semantic-component-base-fill-pressed` SCSS light: `$sds-color-semantic-component-base-fill-pressed` SCSS dark: `$sds-color-semantic-component-base-fill-pressed-dark` |
67
+ | fill-open | | Light: Base.fill-open (rgba(195, 195, 195, 0.2800)) Dark: Base.fill-open (rgba(105, 105, 105, 0.2800)) | | CSS light / dark: `--sds-color-semantic-component-base-fill-open` SCSS light: `$sds-color-semantic-component-base-fill-open` SCSS dark: `$sds-color-semantic-component-base-fill-open-dark` |
68
+ | fill-selected | | Light: Base.fill-selected (#000000) Dark: Base.fill-selected (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-fill-selected` SCSS light: `$sds-color-semantic-component-base-fill-selected` SCSS dark: `$sds-color-semantic-component-base-fill-selected-dark` |
69
+ | fill-disabled | | Light: Base.fill-disabled (#dfdfdf) Dark: Base.fill-disabled (#494949) | | CSS light / dark: `--sds-color-semantic-component-base-fill-disabled` SCSS light: `$sds-color-semantic-component-base-fill-disabled` SCSS dark: `$sds-color-semantic-component-base-fill-disabled-dark` |
70
+
71
+ #### Border and Divider
72
+
73
+ Base Border colors are used for element borders.
74
+
75
+ Base *border-table* is intended to be used only on the borders that separate rows and columns in Tables.
76
+
77
+ Base *divider* is intended to be used only on horizontal dividers that separate blocks of content.
78
+
79
+ | Light Mode | Dark Mode |
80
+ | :---: | :---: |
81
+
82
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
83
+ | --- | --- | --- | --- | --- |
84
+ | border-primary | | Light: Base.border-primary (#7a7a7a) Dark: Base.border-primary (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-component-base-border-primary` SCSS light: `$sds-color-semantic-component-base-border-primary` SCSS dark: `$sds-color-semantic-component-base-border-primary-dark` |
85
+ | border-primary-hover | | Light: Base.border-primary-hover (#000000) Dark: Base.border-primary-hover (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-border-hover` SCSS light: `$sds-color-semantic-component-base-border-primary-hover` SCSS dark: `$sds-color-semantic-component-base-border-primary-hover-dark` |
86
+ | border-primary-pressed | | Light: Base.border-primary-pressed (#000000) Dark: Base.border-primary-pressed (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-border-primary-pressed` SCSS light: `$sds-color-semantic-component-base-border-primary-pressed` SCSS dark: `$sds-color-semantic-component-base-border-primary-pressed-dark` |
87
+ | border-primary-disabled | | Light: Base.border-primary-disabled (#c3c3c3) Dark: Base.border-primary-disabled (#696969) | | CSS light / dark: `--sds-color-semantic-component-base-border-primary-disabled` SCSS light: `$sds-color-semantic-component-base-border-primary-disabled` SCSS dark: `$sds-color-semantic-component-base-border-primary-disabled-dark` |
88
+ | border-secondary | | Light: Base.border-secondary (#c3c3c3) Dark: Base.border-secondary (#696969) | | CSS light / dark: `--sds-color-semantic-component-base-border-secondary` SCSS light: `$sds-color-semantic-component-base-border-secondary` SCSS dark: `$sds-color-semantic-component-base-border-secondary-dark` |
89
+ | border-primary-inverse | | Light: Base.border-primary-inverse (#c3c3c3) Dark: Base.border-primary-inverse (#696969) | | CSS light / dark: `--sds-color-semantic-component-base-border-primary-inverse` SCSS light: `$sds-color-semantic-component-base-border-primary-inverse` SCSS dark: `$sds-color-semantic-component-base-border-primary-inverse-dark` |
90
+ | border-primary-hover-inverse | | Light: Base.border-primary-hover-inverse (#ffffff) Dark: Base.border-primary-hover-inverse (#000000) | | CSS light / dark: `--sds-color-semantic-component-base-border-primary-hover-inverse` SCSS light: `$sds-color-semantic-component-base-border-primary-hover-inverse` SCSS dark: `$sds-color-semantic-component-base-border-primary-hover-inverse-dark` |
91
+ | border-primary-pressed-inverse | | Light: Base.border-primary-pressed-inverse (#ffffff) Dark: Base.border-primary-pressed-inverse (#000000) | | CSS light / dark: `--sds-color-semantic-component-base-border-primary-pressed-inverse` SCSS light: `$sds-color-semantic-component-base-border-primary-pressed-inverse` SCSS dark: `$sds-color-semantic-component-base-border-primary-pressed-inverse-dark` |
92
+ | border-primary-disabled-inverse | | Light: Base.border-primary-disabled-inverse (#7a7a7a) Dark: Base.border-primary-disabled-inverse (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-component-base-border-primary-disabled-inverse` SCSS light: `$sds-color-semantic-component-base-border-primary-disabled-inverse` SCSS dark: `$sds-color-semantic-component-base-border-primary-disabled-inverse-dark` |
93
+ | border-on-fill | | Light: Base.border-on-fill (#ffffff) Dark: Base.border-on-fill (#000000) | | CSS light / dark: `--sds-color-semantic-component-base-border-on-fill` SCSS light: `$sds-color-semantic-component-base-border-on-fill` SCSS dark: `$sds-color-semantic-component-base-border-on-fill-dark` |
94
+ | divider | | Light: Base.divider (#dfdfdf) Dark: Base.divider (#494949) | | CSS light / dark: `--sds-color-semantic-component-base-divider` SCSS light: `$sds-color-semantic-component-base-divider` SCSS dark: `$sds-color-semantic-component-base-divider-dark` |
95
+ | divider-inverse | | Light: Base.divider-inverse (#7a7a7a) Dark: Base.divider-inverse (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-component-base-divider-inverse` SCSS light: `$sds-color-semantic-component-base-divider-inverse` SCSS dark: `$sds-color-semantic-component-base-divider-inverse-dark` |
96
+
97
+ #### Ornament
98
+
99
+ Base Ornament colors are used primarily in components that contain icons that are integral to their functionality, such as Accordions, Dropdown Inputs, etc.
100
+
101
+ When the fill of the element that the ornament is placed on top of is too dark in both Light Mode and Dark Mode, and using the same color in both modes is needed to pass visual accessibility, such as the icon inside primary Buttons, use *ornament-on-fill*.
102
+
103
+ When visual contrast is needed use *ornament-primary-inverse*.
104
+
105
+ | Light Mode | Dark Mode |
106
+ | :---: | :---: |
107
+
108
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
109
+ | --- | --- | --- | --- | --- |
110
+ | ornament-primary | | Light: Base.ornament-primary (#000000) Dark: Base.ornament-primary (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-primary` SCSS light: `$sds-color-semantic-component-base-ornament-primary` SCSS dark: `$sds-color-semantic-component-base-ornament-primary-dark` |
111
+ | ornament-secondary | | Light: Base.ornament-secondary (#7a7a7a) Dark: Base.ornament-secondary (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-secondary` SCSS light: `$sds-color-semantic-component-base-ornament-secondary` SCSS dark: `$sds-color-semantic-component-base-ornament-secondary-dark` |
112
+ | ornament-secondary-hover | | Light: Base.ornament-secondary-hover (#000000) Dark: Base.ornament-secondary-hover (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-secondary-hover` SCSS light: `$sds-color-semantic-component-base-ornament-secondary-hover` SCSS dark: `$sds-color-semantic-component-base-ornament-secondary-hover-dark` |
113
+ | ornament-secondary-pressed | | Light: Base.ornament-secondary-pressed (#000000) Dark: Base.ornament-secondary-pressed (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-secondary-pressed` SCSS light: `$sds-color-semantic-component-base-ornament-secondary-pressed` SCSS dark: `$sds-color-semantic-component-base-ornament-secondary-pressed-dark` |
114
+ | ornament-primary-inverse | | Light: Base.ornament-primary-inverse (#ffffff) Dark: Base.ornament-primary-inverse (#000000) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-primary-inverse` SCSS light: `$sds-color-semantic-component-base-ornament-primary-inverse` SCSS dark: `$sds-color-semantic-component-base-ornament-primary-inverse-dark` |
115
+ | ornament-secondary-inverse | | Light: Base.ornament-secondary-inverse (#c3c3c3) Dark: Base.ornament-secondary-inverse (#696969) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-secondary-inverse` SCSS light: `$sds-color-semantic-component-base-ornament-secondary-inverse` SCSS dark: `$sds-color-semantic-component-base-ornament-secondary-inverse-dark` |
116
+ | ornament-on-fill | | Light: Base.ornament-on-fill (#ffffff) Dark: Base.ornament-on-fill (#ffffff) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-on-fill` SCSS light: `$sds-color-semantic-component-base-ornament-on-fill` SCSS dark: `$sds-color-semantic-component-base-ornament-on-fill-dark` |
117
+ | ornament-disabled | | Light: Base.ornament-disabled (#c3c3c3) Dark: Base.ornament-disabled (#696969) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-disabled` SCSS light: `$sds-color-semantic-component-base-ornament-disabled` SCSS dark: `$sds-color-semantic-component-base-ornament-disabled-dark` |
118
+ | ornament-disabled-inverse | | Light: Base.ornament-disabled-inverse (#7a7a7a) Dark: Base.ornament-disabled-inverse (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-component-base-ornament-disabled-inverse` SCSS light: `$sds-color-semantic-component-base-ornament-disabled-inverse` SCSS dark: `$sds-color-semantic-component-base-ornament-disabled-inverse-dark` |
119
+
120
+ #### Text
121
+
122
+ Base Text colors are to be used for text throughout applications built using SDS.
123
+
124
+ If there is a need to communicate that a text element is interactive, such as a Link, or indicate a specific intent, such as beta, info, negative, neutral, notice, or positive, use the Text Color variable that aligns to those needs as shown in the corresponding sections below.
125
+
126
+ Base *text-primary-inverse* and *text-secondary-inverse* are used only when the fill of the element that the text is placed on top of is too dark or light to be legible and an alternate color is needed to pass visual accessibility, such as the text inside inverted Tooltips.
127
+
128
+ When the fill of the element that the text is placed on top of is too dark in both Light Mode and Dark Mode, and using the same color in both modes is needed to pass visual accessibility, such as the text inside primary Buttons, use *text-on-fill*.
129
+
130
+ | Light Mode | Dark Mode |
131
+ | :---: | :---: |
132
+
133
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
134
+ | --- | --- | --- | --- | --- |
135
+ | primary | | Light: Text.primary (#000000) Dark: Text.primary (#ffffff) | | CSS light / dark: `--sds-color-semantic-base-text-primary` SCSS light: `$sds-color-semantic-base-text-primary` SCSS dark: `$sds-color-semantic-base-text-primary-dark` |
136
+ | secondary | | Light: Text.secondary (#7a7a7a) Dark: Text.secondary (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-base-text-secondary` SCSS light: `$sds-color-semantic-base-text-secondary` SCSS dark: `$sds-color-semantic-base-text-secondary-dark` |
137
+ | tertiary | | Light: Text.tertiary (#a5a5a5) Dark: Text.tertiary (#9b9b9b) | | CSS light / dark: `--sds-color-semantic-base-text-tertiary` SCSS light: `$sds-color-semantic-base-text-tertiary` SCSS dark: `$sds-color-semantic-base-text-tertiary-dark` |
138
+ | primary-inverse | | Light: Text.primary-inverse (#ffffff) Dark: Text.primary-inverse (#000000) | | CSS light / dark: `--sds-color-semantic-base-text-primary-inverse` SCSS light: `$sds-color-semantic-base-text-primary-inverse` SCSS dark: `$sds-color-semantic-base-text-primary-inverse-dark` |
139
+ | secondary-inverse | | Light: Text.secondary-inverse (#c3c3c3) Dark: Text.secondary-inverse (#696969) | | CSS light / dark: `--sds-color-semantic-base-text-secondary-inverse` SCSS light: `$sds-color-semantic-text-base-secondary-inverse` SCSS dark: `$sds-color-semantic-text-base-secondary-inverse-dark` |
140
+ | tertiary-inverse | | Light: Text.tertiary-inverse (#969696) Dark: Text.tertiary-inverse (#aaaaaa) | | CSS light / dark: `--sds-color-semantic-base-text-tertiary-inverse` SCSS light: `$sds-color-semantic-base-text-tertiary-inverse` SCSS dark: `$sds-color-semantic-base-text-tertiary-inverse-dark` |
141
+ | on-fill | | Light: Text.on-fill (#ffffff) Dark: Text.on-fill (#ffffff) | | CSS light / dark: `--sds-color-semantic-base-text-on-fill` SCSS light: `$sds-color-semantic-base-text-on-fill` SCSS dark: `$sds-color-semantic-base-text-on-fill-dark` |
142
+ | disabled | | Light: Text.disabled (#c3c3c3) Dark: Text.disabled (#696969) | | CSS light / dark: `--sds-color-semantic-base-text-disabled` SCSS light: `$sds-color-semantic-base-text-disabled` SCSS dark: `$sds-color-semantic-base-text-disabled-dark` |
143
+ | disabled-inverse | | Light: Text.disabled-inverse (#7a7a7a) Dark: Text.disabled-inverse (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-base-text-disabled-inverse` SCSS light: `$sds-color-semantic-base-text-disabled-inverse` SCSS dark: `$sds-color-semantic-base-text-disabled-inverse-dark` |
144
+
145
+ ---
146
+
147
+ ### Action Colors
148
+
149
+ #### Text
150
+
151
+ Action Text colors are used to communicate that a block of text is interactive, such as a Link.
152
+
153
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
154
+ | --- | --- | --- | --- | --- |
155
+ | action | | Light: Text.action (#1a6cef) Dark: Text.action (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-accent-text-action` SCSS light: `$sds-color-semantic-accent-text-action` SCSS dark: `$sds-color-semantic-accent-text-action-dark` |
156
+ | action-hover | | Light: Text.action-hover (#0041b9) Dark: Text.action-hover (#cde3ff) | | CSS light / dark: `--sds-color-semantic-accent-text-action-hover` SCSS light: `$sds-color-semantic-accent-text-action-hover` SCSS dark: `$sds-color-semantic-accent-text-action-hover-dark` |
157
+ | action-pressed | | Light: Text.action-pressed (#002d90) Dark: Text.action-pressed (#e2eeff) | | CSS light / dark: `--sds-color-semantic-accent-text-action-pressed` SCSS light: `$sds-color-semantic-accent-text-action-pressed` SCSS dark: `$sds-color-semantic-accent-text-action-pressed-dark` |
158
+
159
+ ---
160
+
161
+ ### Accent Colors
162
+
163
+ #### Surface
164
+
165
+ Accent Surface colors are used for the background and fills of non-interactive elements or sections that use an application's primary color.
166
+
167
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
168
+ | --- | --- | --- | --- | --- |
169
+ | surface-primary | | Light: Accent.surface-primary (#1a6cef) Dark: Accent.surface-primary (#2573f4) | | CSS light / dark: `--sds-color-semantic-component-accent-surface-primary` SCSS light: `$sds-color-semantic-component-accent-surface-primary` SCSS dark: `$sds-color-semantic-component-accent-surface-primary-dark` |
170
+ | surface-secondary | | Light: Accent.surface-secondary (#edf3fd) Dark: Accent.surface-secondary (#0f1d4a) | | CSS light / dark: `--sds-color-semantic-component-accent-surface-secondary` SCSS light: `$sds-color-semantic-component-accent-surface-secondary` SCSS dark: `$sds-color-semantic-component-accent-surface-secondary-dark` |
171
+
172
+ #### Fill
173
+
174
+ Accent Fill Colors are used on elements where the primary color is needed that are interactive and change in response to users hovering, pressing, etc.
175
+
176
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
177
+ | --- | --- | --- | --- | --- |
178
+ | fill-primary | | Light: Accent.fill-primary (#1a6cef) Dark: Accent.fill-primary (#2573f4) | | CSS light / dark: `--sds-color-semantic-component-accent-fill-primary` SCSS light: `$sds-color-semantic-component-accent-fill-primary` SCSS dark: `$sds-color-semantic-component-accent-fill-primary-dark` |
179
+ | fill-hover | | Light: Accent.fill-hover (#0041b9) Dark: Accent.fill-hover (#cde3ff) | | CSS light / dark: `--sds-color-semantic-component-accent-fill-hover` SCSS light: `$sds-color-semantic-component-accent-fill-hover` SCSS dark: `$sds-color-semantic-component-accent-fill-hover-dark` |
180
+ | fill-pressed | | Light: Accent.fill-pressed (#002d90) Dark: Accent.fill-pressed (#e2eeff) | | CSS light / dark: `--sds-color-semantic-component-accent-fill-pressed` SCSS light: `$sds-color-semantic-component-accent-fill-pressed` SCSS dark: `$sds-color-semantic-component-accent-fill-pressed-dark` |
181
+
182
+ #### Border
183
+
184
+ Accent Border Colors are used on interactive elements with borders.
185
+
186
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
187
+ | --- | --- | --- | --- | --- |
188
+ | border | | Light: Accent.border (#1a6cef) Dark: Accent.border (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-border` SCSS light: `$sds-color-semantic-component-accent-border` SCSS dark: `$sds-color-semantic-component-accent-border-dark` |
189
+ | border-hover | | Light: Accent.border-hover (#0041b9) Dark: Accent.border-hover (#cde3ff) | | CSS light / dark: `--sds-color-semantic-component-accent-border-hover` SCSS light: `$sds-color-semantic-component-accent-border-hover` SCSS dark: `$sds-color-semantic-component-accent-border-hover-dark` |
190
+ | border-pressed | | Light: Accent.border-pressed (#002d90) Dark: Accent.border-pressed (#e2eeff) | | CSS light / dark: `--sds-color-semantic-component-accent-border-pressed` SCSS light: `$sds-color-semantic-component-accent-border-pressed` SCSS dark: `$sds-color-semantic-component-accent-border-pressed-dark` |
191
+ | border-open | | Light: Accent.border-open (#1a6cef) Dark: Accent.border-open (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-border-open` SCSS light: `$sds-color-semantic-component-accent-border-open` SCSS dark: `$sds-color-semantic-component-accent-border-open-dark` |
192
+ | border-focus | | Light: Accent.border-focus (#1a6cef) Dark: Accent.border-focus (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-border-focus` SCSS light: `$sds-color-semantic-component-accent-border-focus` SCSS dark: `$sds-color-semantic-component-accent-border-focus-dark` |
193
+ | border-selected | | Light: Accent.border-selected (#1a6cef) Dark: Accent.border-selected (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-border-selected` SCSS light: `$sds-color-semantic-component-accent-border-selected` SCSS dark: `$sds-color-semantic-component-accent-border-selected-dark` |
194
+
195
+ #### Ornament
196
+
197
+ Accent *ornament* is used whenever an interactive element contains an icon or other small area of color that needs to be displayed in the accent color.
198
+
199
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
200
+ | --- | --- | --- | --- | --- |
201
+ | ornament | | Light: Accent.ornament (#1a6cef) Dark: Accent.ornament (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-ornament` SCSS light: `$sds-color-semantic-component-accent-ornament` SCSS dark: `$sds-color-semantic-component-accent-ornament-dark` |
202
+ | ornament-hover | | Light: Accent.ornament-hover (#0041b9) Dark: Accent.ornament-hover (#cde3ff) | | CSS light / dark: `--sds-color-semantic-component-accent-ornament-hover` SCSS light: `$sds-color-semantic-component-accent-ornament-hover` SCSS dark: `$sds-color-semantic-component-accent-ornament-hover-dark` |
203
+ | ornament-pressed | | Light: Accent.ornament-pressed (#002d90) Dark: Accent.ornament-pressed (#e2eeff) | | CSS light / dark: `--sds-color-semantic-component-accent-ornament-pressed` SCSS light: `$sds-color-semantic-component-accent-ornament-pressed` SCSS dark: `$sds-color-semantic-component-accent-ornament-pressed-dark` |
204
+ | ornament-open | | Light: Accent.ornament-open (#1a6cef) Dark: Accent.ornament-open (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-ornament-open` SCSS light: `$sds-color-semantic-component-accent-ornament-open` SCSS dark: `$sds-color-semantic-component-accent-ornament-open-dark` |
205
+ | ornament-focus | | Light: Accent.ornament-focus (#1a6cef) Dark: Accent.ornament-focus (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-ornament-focus` SCSS light: `$sds-color-semantic-component-accent-ornament-focus` SCSS dark: `$sds-color-semantic-component-accent-ornament-focus-dark` |
206
+ | ornament-selected | | Light: Accent.ornament-selected (#1a6cef) Dark: Accent.ornament-selected (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-accent-ornament-selected` SCSS light: `$sds-color-semantic-component-accent-ornament-selected` SCSS dark: `$sds-color-semantic-component-accent-ornament-selected-dark` |
207
+
208
+ ---
209
+
210
+ ### Beta Colors
211
+
212
+ #### Surface
213
+
214
+ Beta Surface colors are used for the backgrounds and fills of non-interactive elements or sections that communicate a Beta intent.
215
+
216
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
217
+ | --- | --- | --- | --- | --- |
218
+ | surface-primary | | Light: Beta.surface-primary (#8b54e2) Dark: Beta.surface-primary (#905de6) | | CSS light / dark: `--sds-color-semantic-component-beta-surface-primary` SCSS light: `$sds-color-semantic-component-beta-surface-primary` SCSS dark: `$sds-color-semantic-component-beta-surface-primary-dark` |
219
+ | surface-secondary | | Light: Beta.surface-secondary (#efeafe) Dark: Beta.surface-secondary (#331252) | | CSS light / dark: `--sds-color-semantic-component-beta-surface-secondary` SCSS light: `$sds-color-semantic-component-beta-surface-secondary` SCSS dark: `$sds-color-semantic-component-beta-surface-secondary-dark` |
220
+
221
+ #### Fill
222
+
223
+ Beta Fill Colors are used on elements that are interactive and change in response to users hovering, pressing, etc. where a Beta intent needs to be communicated.
224
+
225
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
226
+ | --- | --- | --- | --- | --- |
227
+ | fill-primary | | Light: Beta.fill-primary (#8b54e2) Dark: Beta.fill-primary (#905de6) | | CSS light / dark: `--sds-color-semantic-component-beta-fill-primary` SCSS light: `$sds-color-semantic-component-beta-fill-primary` SCSS dark: `$sds-color-semantic-component-beta-fill-primary-dark` |
228
+ | fill-hover | | Light: Beta.fill-hover (#6526b5) Dark: Beta.fill-hover (#e4dcfc) | | CSS light / dark: `--sds-color-semantic-component-beta-fill-hover` SCSS light: `$sds-color-semantic-component-beta-fill-hover` SCSS dark: `$sds-color-semantic-component-beta-fill-hover-dark` |
229
+ | fill-pressed | | Light: Beta.fill-pressed (#490092) Dark: Beta.fill-pressed (#f0ebfe) | | CSS light / dark: `--sds-color-semantic-component-beta-fill-pressed` SCSS light: `$sds-color-semantic-component-beta-fill-pressed` SCSS dark: `$sds-color-semantic-component-beta-fill-pressed-dark` |
230
+ | fill-secondary | | Light: Beta.fill-secondary (#efeafe) Dark: Beta.fill-secondary (#331252) | | CSS light / dark: `--sds-color-semantic-component-beta-fill-secondary` SCSS light: `$sds-color-semantic-component-beta-fill-secondary` SCSS dark: `$sds-color-semantic-component-beta-fill-secondary-dark` |
231
+
232
+ #### Border
233
+
234
+ Beta *border* is used on element borders that need to communicate a Beta intent.
235
+
236
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
237
+ | --- | --- | --- | --- | --- |
238
+ | border | | Light: Beta.border (#6526b5) Dark: Beta.border (#cebef8) | | CSS light / dark: `--sds-color-semantic-component-beta-border` SCSS light: `$sds-color-semantic-component-beta-border` SCSS dark: `$sds-color-semantic-component-beta-border-dark` |
239
+
240
+ #### Ornament
241
+
242
+ Beta *ornament* is used whenever a Beta intent needs to be communicated visually on an icon or other small colored element.
243
+
244
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
245
+ | --- | --- | --- | --- | --- |
246
+ | ornament | | Light: Beta.ornament (#6526b5) Dark: Beta.ornament (#cebef8) | | CSS light / dark: `--sds-color-semantic-component-beta-ornament` SCSS light: `$sds-color-semantic-component-beta-ornament` SCSS dark: `$sds-color-semantic-component-beta-ornament-dark` |
247
+
248
+ #### Text
249
+
250
+ The Beta *text* variable is used whenever text needs to communicate a Beta intent.
251
+
252
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
253
+ | --- | --- | --- | --- | --- |
254
+ | text-beta | | Light: Text.beta (#6526b5) Dark: Text.beta (#cebef8) | | CSS light / dark: `--sds-color-semantic-component-beta-text` SCSS light: `$sds-color-semantic-component-beta-text` SCSS dark: `$sds-color-semantic-component-beta-text-dark` |
255
+
256
+ ---
257
+
258
+ ### Info Colors
259
+
260
+ #### Surface
261
+
262
+ Info Surface colors are used for the backgrounds and fills of non-interactive elements or sections that communicate an Info intent.
263
+
264
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
265
+ | --- | --- | --- | --- | --- |
266
+ | surface-primary | | Light: Info.surface-primary (#1a6cef) Dark: Info.surface-primary (#2573f4) | | CSS light / dark: `--sds-color-semantic-component-info-surface-primary` SCSS light: `$sds-color-semantic-component-info-surface-primary` SCSS dark: `$sds-color-semantic-component-info-surface-primary-dark` |
267
+ | surface-secondary | | Light: Info.surface-secondary (#edf3fd) Dark: Info.surface-secondary (#0f1d4a) | | CSS light / dark: `--sds-color-semantic-component-info-surface-secondary` SCSS light: `$sds-color-semantic-component-info-surface-secondary` SCSS dark: `$sds-color-semantic-component-info-surface-secondary-dark` |
268
+
269
+ #### Fill
270
+
271
+ Info Fill Colors are used on elements that are interactive and change in response to users hovering, pressing, etc. where an Info intent needs to be communicated.
272
+
273
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
274
+ | --- | --- | --- | --- | --- |
275
+ | fill-primary | | Light: Info.fill-primary (#1a6cef) Dark: Info.fill-primary (#2573f4) | | CSS light / dark: `--sds-color-semantic-component-info-fill-primary` SCSS light: `$sds-color-semantic-component-info-fill-primary` SCSS dark: `$sds-color-semantic-component-info-fill-primary-dark` |
276
+ | fill-hover | | Light: Info.fill-hover (#0041b9) Dark: Info.fill-hover (#cde3ff) | | CSS light / dark: `--sds-color-semantic-component-info-fill-hover` SCSS light: `$sds-color-semantic-component-info-fill-hover` SCSS dark: `$sds-color-semantic-component-info-fill-hover-dark` |
277
+ | fill-pressed | | Light: Info.fill-pressed (#002d90) Dark: Info.fill-pressed (#e2eeff) | | CSS light / dark: `--sds-color-semantic-component-info-fill-pressed` SCSS light: `$sds-color-semantic-component-info-fill-pressed` SCSS dark: `$sds-color-semantic-component-info-fill-pressed-dark` |
278
+ | fill-secondary | | Light: Info.fill-secondary (#edf3fd) Dark: Info.fill-secondary (#0f1d4a) | | CSS light / dark: `--sds-color-semantic-component-info-fill-secondary` SCSS light: `$sds-color-semantic-component-info-fill-secondary` SCSS dark: `$sds-color-semantic-component-info-fill-secondary-dark` |
279
+
280
+ #### Border
281
+
282
+ Info *border* is used on element borders that need to communicate an Info intent.
283
+
284
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
285
+ | --- | --- | --- | --- | --- |
286
+ | border | | Light: Info.border (#0041b9) Dark: Info.border (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-info-border` SCSS light: `$sds-color-semantic-component-info-border` SCSS dark: `$sds-color-semantic-component-info-border-dark` |
287
+
288
+ #### Ornament
289
+
290
+ Info *ornament* is used whenever an Info intent needs to be communicated visually on an icon or other small colored element.
291
+
292
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
293
+ | --- | --- | --- | --- | --- |
294
+ | ornament | | Light: Info.ornament (#0041b9) Dark: Info.ornament (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-info-ornament` SCSS light:`$sds-color-semantic-component-info-ornament` SCSS dark: `$sds-color-semantic-component-info-ornament-dark` |
295
+
296
+ #### Text
297
+
298
+ The info *text* variable is used whenever text needs to communicate an Info intent.
299
+
300
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
301
+ | --- | --- | --- | --- | --- |
302
+ | text-info | | Light: Text.info (#0041b9) Dark: Text.info (#a2c9ff) | | CSS light / dark: `--sds-color-semantic-component-info-text` SCSS light: `$sds-color-semantic-component-info-text` SCSS dark: `$sds-color-semantic-component-info-text-dark` |
303
+
304
+ ---
305
+
306
+ ### Negative Colors
307
+
308
+ #### Surface
309
+
310
+ Negative Surface colors are used for the backgrounds and fills of non-interactive elements or sections that communicate a Negative intent.
311
+
312
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
313
+ | --- | --- | --- | --- | --- |
314
+ | surface-primary | | Light: Negative.surface-primary (#db2131) Dark: Negative.surface-primary (#c73028) | | CSS light / dark: `--sds-color-semantic-component-negative-surface-primary` SCSS light: `$sds-color-semantic-component-negative-surface-primary` SCSS dark: `$sds-color-semantic-component-negative-surface-primary-dark` |
315
+ | surface-secondary | | Light: Negative.surface-secondary (#ffe8e6) Dark: Negative.surface-secondary (#330603) | | CSS light / dark: `--sds-color-semantic-component-negative-surface-secondary` SCSS light: `$sds-color-semantic-component-negative-surface-secondary` SCSS dark: `$sds-color-semantic-component-negative-surface-secondary-dark` |
316
+
317
+ #### Fill
318
+
319
+ Negative Fill Colors are used on elements that are interactive and change in response to users hovering, pressing, etc. where a Negative intent needs to be communicated.
320
+
321
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
322
+ | --- | --- | --- | --- | --- |
323
+ | fill-primary | | Light: Negative.fill-primary (#db2131) Dark: Negative.fill-primary (#c73028) | | CSS light / dark: `--sds-color-semantic-component-negative-fill-primary` SCSS light: `$sds-color-semantic-component-negative-fill-primary` SCSS dark: `$sds-color-semantic-component-negative-fill-primary-dark` |
324
+ | fill-hover | | Light: Negative.fill-hover (#b80017) Dark: Negative.fill-hover (#ffbdb3) | | CSS light / dark: `--sds-color-semantic-component-negative-fill-hover` SCSS light: `$sds-color-semantic-component-negative-fill-hover` SCSS dark: `$sds-color-semantic-component-negative-fill-hover-dark` |
325
+ | fill-pressed | | Light: Negative.fill-pressed (#6f0008) Dark: Negative.fill-pressed (#ffd8d1) | | CSS light / dark: `--sds-color-semantic-component-negative-fill-pressed` SCSS light: `$sds-color-semantic-component-negative-fill-pressed` SCSS dark: `$sds-color-semantic-component-negative-fill-pressed-dark` |
326
+ | fill-secondary | | Light: Negative.fill-secondary (#ffe8e6) Dark: Negative.fill-secondary (#330603) | | CSS light / dark: `--sds-color-semantic-component-negative-fill-secondary` SCSS light: `$sds-color-semantic-component-negative-fill-secondary` SCSS dark: `$sds-color-semantic-component-negative-fill-secondary-dark` |
327
+
328
+ #### Border
329
+
330
+ Negative *border* is used on element borders that need to communicate a Negative intent.
331
+
332
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
333
+ | --- | --- | --- | --- | --- |
334
+ | border | | Light: Negative.border (#b80017) Dark: Negative.border (#ff988a) | | CSS light / dark: `--sds-color-semantic-component-negative-border` SCSS light: `$sds-color-semantic-component-negative-border` SCSS dark: `$sds-color-semantic-component-negative-border-dark` |
335
+
336
+ #### Ornament
337
+
338
+ Negative *ornament* is used whenever a Negative intent needs to be communicated visually on an icon or other small colored element.
339
+
340
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
341
+ | --- | --- | --- | --- | --- |
342
+ | ornament | | Light: Negative.ornament (#b80017) Dark: Negative.ornament (#ff988a) | | CSS light / dark: `--sds-color-semantic-component-negative-ornament` SCSS light: `$sds-color-semantic-component-negative-ornament` SCSS dark: `$sds-color-semantic-component-negative-ornament-dark` |
343
+
344
+ #### Text
345
+
346
+ The negative *text* variable is used whenever text needs to communicate a Negative intent.
347
+
348
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
349
+ | --- | --- | --- | --- | --- |
350
+ | text-negative | | Light: Text.negative (#b80017) Dark: Text.negative (#ff988a) | | CSS light / dark: `--sds-color-semantic-component-negative-text` SCSS light: `$sds-color-semantic-component-negative-text` SCSS dark: `$sds-color-semantic-component-negative-text-dark` |
351
+
352
+ ---
353
+
354
+ ### Neutral Colors
355
+
356
+ >**Note:** Neutral Colors are only used in components that display an intent, such as Tags. For these elements, Neutral Colors communicate that there is no intent indicated.
357
+
358
+ #### Surface
359
+
360
+ Neutral Surface colors are used for the backgrounds and fills of non-interactive elements or sections that communicate have no intent.
361
+
362
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
363
+ | --- | --- | --- | --- | --- |
364
+ | surface-primary | | Light: Neutral.surface-primary (#969696) Dark: Neutral.surface-primary (#aaaaaa) | | CSS light / dark: `--sds-color-semantic-component-neutral-surface-primary` SCSS light: `$sds-color-semantic-component-neutral-surface-primary` SCSS dark: `$sds-color-semantic-component-neutral-surface-primary-dark` |
365
+ | surface-secondary | | Light: Neutral.surface-secondary (#dfdfdf) Dark: Neutral.surface-secondary (#494949) | | CSS light / dark: `--sds-color-semantic-component-neutral-surface-secondary` SCSS light: `$sds-color-semantic-component-neutral-surface-secondary` SCSS dark: `$sds-color-semantic-component-neutral-surface-secondary-dark` |
366
+
367
+ #### Fill
368
+
369
+ Neutral Fill Colors are used on elements that are interactive and change in response to users hovering, pressing, etc. where there is no intent to be communicated.
370
+
371
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
372
+ | --- | --- | --- | --- | --- |
373
+ | fill-primary | | Light: Neutral.fill-primary (#969696) Dark: Neutral.fill-primary (#aaaaaa) | | CSS light / dark: `--sds-color-semantic-component-neutral-fill-primary` SCSS light: `$sds-color-semantic-component-neutral-fill-primary` SCSS dark: `$sds-color-semantic-component-neutral-fill-primary-dark` |
374
+ | fill-hover | | Light: Neutral.fill-hover (#7a7a7a) Dark: Neutral.fill-hover (#cdcdcd) | | CSS light / dark: `--sds-color-semantic-component-neutral-fill-hover` SCSS light: `$sds-color-semantic-component-neutral-fill-hover` SCSS dark: `$sds-color-semantic-component-neutral-fill-hover-dark` |
375
+ | fill-pressed | | Light: Neutral.fill-pressed (#3b3b3b) Dark: Neutral.fill-pressed (#ededed) | | CSS light / dark: `--sds-color-semantic-component-neutral-fill-pressed` SCSS light: `$sds-color-semantic-component-neutral-fill-pressed` SCSS dark: `$sds-color-semantic-component-neutral-fill-pressed-dark` |
376
+ | fill-secondary | | Light: Neutral.fill-secondary (#dfdfdf) Dark: Neutral.fill-secondary (#494949) | | CSS light / dark: `--sds-color-semantic-component-neutral-fill-secondary` SCSS light: `$sds-color-semantic-component-neutral-fill-secondary` SCSS dark: `$sds-color-semantic-component-neutral-fill-secondary-dark` |
377
+
378
+ #### Border
379
+
380
+ Neutral *border* is used on element borders that need to communicate there is no intent.
381
+
382
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
383
+ | --- | --- | --- | --- | --- |
384
+ | border | | Light: Neutral.border (#969696) Dark: Neutral.border (#aaaaaa) | | CSS light / dark: `--sds-color-semantic-component-neutral-border` SCSS light: `$sds-color-semantic-component-neutral-border` SCSS dark: `$sds-color-semantic-component-neutral-border-dark` |
385
+
386
+ #### Ornament
387
+
388
+ Neutral *ornament* is used whenever there is no intent to be communicated visually on an icon or other small colored element.
389
+
390
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
391
+ | --- | --- | --- | --- | --- |
392
+ | ornament | | Light: Neutral.ornament (#3b3b3b) Dark: Neutral.ornament (#ededed) | | CSS light / dark: `--sds-color-semantic-component-neutral-ornament` SCSS light: `$sds-color-semantic-component-neutral-ornament` SCSS dark: `$sds-color-semantic-component-neutral-ornament-dark` |
393
+
394
+ #### Text
395
+
396
+ The neutral *text* variable is used whenever text needs to communicate there is no intent.
397
+
398
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
399
+ | --- | --- | --- | --- | --- |
400
+ | text-neutral | | Light: Text.neutral (#3b3b3b) Dark: Text.neutral (#ededed) | | CSS light / dark: `--sds-color-semantic-component-neutral-text` SCSS light: `$sds-color-semantic-component-neutral-text` SCSS dark: `$sds-color-semantic-component-neutral-text-dark` |
401
+
402
+ ---
403
+
404
+ ### Notice Colors
405
+
406
+ #### Surface
407
+
408
+ Notice Surface colors are used for the backgrounds and fills of non-interactive elements or sections that communicate a Notice intent.
409
+
410
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
411
+ | --- | --- | --- | --- | --- |
412
+ | surface-primary | | Light: Notice.surface-primary (#da9900) Dark: Notice.surface-primary (#bd8804) | | CSS light / dark: `--sds-color-semantic-component-notice-surface-primary` SCSS light: `$sds-color-semantic-component-notice-surface-primary` SCSS dark: `$sds-color-semantic-component-notice-surface-primary-dark` |
413
+ | surface-secondary | | Light: Notice.surface-secondary (#fff3db) Dark: Notice.surface-secondary (#361b07) | | CSS light / dark: `--sds-color-semantic-component-notice-surface-secondary` SCSS light: `$sds-color-semantic-component-notice-surface-secondary` SCSS dark: `$sds-color-semantic-component-notice-surface-secondary-dark` |
414
+
415
+ #### Fill
416
+
417
+ Notice Fill Colors are used on elements that are interactive and change in response to users hovering, pressing, etc. where a Notice intent needs to be communicated.
418
+
419
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
420
+ | --- | --- | --- | --- | --- |
421
+ | fill-primary | | Light: Notice.fill-primary (#da9900) Dark: Notice.fill-primary (#bd8804) | | CSS light / dark: `--sds-color-semantic-component-notice-fill-primary` SCSS light: `$sds-color-semantic-component-notice-fill-primary` SCSS dark: `$sds-color-semantic-component-notice-fill-primary-dark` |
422
+ | fill-hover | | Light: Notice.fill-hover (#b07300) Dark: Notice.fill-hover (#f5d789) | | CSS light / dark: `--sds-color-semantic-component-notice-fill-hover` SCSS light: `$sds-color-semantic-component-notice-fill-hover` SCSS dark: `$sds-color-semantic-component-notice-fill-hover-dark` |
423
+ | fill-pressed | | Light: Notice.fill-pressed (#7c3e00) Dark: Notice.fill-pressed (#ffe6a8) | | CSS light / dark: `--sds-color-semantic-component-notice-fill-pressed` SCSS light: `$sds-color-semantic-component-notice-fill-pressed` SCSS dark: `$sds-color-semantic-component-notice-fill-pressed-dark` |
424
+ | fill-secondary | | Light: Notice.fill-secondary (#fff3db) Dark: Notice.fill-secondary (#361b07) | | CSS light / dark: `--sds-color-semantic-component-notice-fill-secondary` SCSS light: `$sds-color-semantic-component-notice-fill-secondary` SCSS dark: `$sds-color-semantic-component-notice-fill-secondary-dark` |
425
+
426
+ #### Border
427
+
428
+ Notice *border* is used on element borders that need to communicate a Notice intent.
429
+
430
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
431
+ | --- | --- | --- | --- | --- |
432
+ | border | | Light: Notice.border (#b07300) Dark: Notice.border (#e5bc63) | | CSS light / dark: `--sds-color-semantic-component-notice-border` SCSS light: `$sds-color-semantic-component-notice-border` SCSS dark: `$sds-color-semantic-component-notice-border-dark` |
433
+
434
+ #### Ornament
435
+
436
+ Notice *ornament* is used whenever a Notice intent needs to be communicated visually on an icon or other small colored element.
437
+
438
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
439
+ | --- | --- | --- | --- | --- |
440
+ | ornament | | Light: Notice.ornament (#b07300) Dark: Notice.ornament (#e5bc63) | | CSS light / dark: `--sds-color-semantic-component-notice-ornament` SCSS light: `$sds-color-semantic-component-notice-ornament` SCSS dark: `$sds-color-semantic-component-notice-ornament-dark` |
441
+
442
+ #### Text
443
+
444
+ The notice *text* variable is used whenever text needs to communicate a Notice intent.
445
+
446
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
447
+ | --- | --- | --- | --- | --- |
448
+ | text-notice | | Light: Text.notice (#b07300) Dark: Text.notice (#e5bc63) | | CSS light / dark: `--sds-color-semantic-component-notice-text` SCSS light: `$sds-color-semantic-component-notice-text` SCSS dark: `$sds-color-semantic-component-notice-text-dark` |
449
+
450
+ ---
451
+
452
+ ### Positive Colors
453
+
454
+ #### Surface
455
+
456
+ Positive Surface colors are used for the backgrounds and fills of non-interactive elements or sections that communicate a Positive intent.
457
+
458
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
459
+ | --- | --- | --- | --- | --- |
460
+ | surface-primary | | Light: Positive.surface-primary (#238444) Dark: Positive.surface-primary (#278b48) | | CSS light / dark: `--sds-color-semantic-component-positive-surface-primary` SCSS light: `$sds-color-semantic-component-positive-surface-primary` `$sds-color-semantic-component-positive-surface-primary-dark` |
461
+ | surface-secondary | | Light: Positive.surface-secondary (#ebf9ed) Dark: Positive.surface-secondary (#082608) | | CSS light / dark: `--sds-color-semantic-component-positive-surface-secondary` SCSS light: `$sds-color-semantic-component-positive-surface-secondary` SCSS dark: `$sds-color-semantic-component-positive-surface-secondary-dark` |
462
+
463
+ #### Fill
464
+
465
+ Positive Fill Colors are used on elements that are interactive and change in response to users hovering, pressing, etc. where a Positive intent needs to be communicated.
466
+
467
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
468
+ | --- | --- | --- | --- | --- |
469
+ | fill-primary | | Light: Positive.fill-primary (#238444) Dark: Positive.fill-primary (#278b48) | | CSS light / dark: `--sds-color-semantic-component-positive-fill-primary` SCSS light: `$sds-color-semantic-component-positive-fill-primary` SCSS dark: `$sds-color-semantic-component-positive-fill-primary-dark` |
470
+ | fill-hover | | Light: Positive.fill-hover (#105b2b) Dark: Positive.fill-hover (#bcecc5) | | CSS light / dark: `--sds-color-semantic-component-positive-fill-hover` SCSS light: `$sds-color-semantic-component-positive-fill-hover` SCSS dark: `$sds-color-semantic-component-positive-fill-hover-dark` |
471
+ | fill-pressed | | Light: Positive.fill-pressed (#07431d) Dark: Positive.fill-pressed (#daf4de) | | CSS light / dark: `--sds-color-semantic-component-positive-fill-pressed` SCSS light: `$sds-color-semantic-component-positive-fill-pressed` SCSS dark: `$sds-color-semantic-component-positive-fill-pressed-dark` |
472
+ | fill-secondary | | Light: Positive.fill-secondary (#ebf9ed) Dark: Positive.fill-secondary (#082608) | | CSS light / dark: `--sds-color-semantic-component-positive-fill-secondary` SCSS light: `$sds-color-semantic-component-positive-fill-secondary` SCSS dark: `$sds-color-semantic-component-positive-fill-secondary-dark` |
473
+
474
+ #### Border
475
+
476
+ Positive *border* is used on element borders that need to communicate a Positive intent.
477
+
478
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
479
+ | --- | --- | --- | --- | --- |
480
+ | border | | Light: Positive.border (#105b2b) Dark: Positive.border (#85d898) | | CSS light / dark: `--sds-color-semantic-component-positive-border` SCSS light: `$sds-color-semantic-component-positive-border` SCSS dark: `$sds-color-semantic-component-positive-border-dark` |
481
+
482
+ #### Ornament
483
+
484
+ Positive *ornament* is used whenever a Positive intent needs to be communicated visually on an icon or other small colored element.
485
+
486
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
487
+ | --- | --- | --- | --- | --- |
488
+ | ornament | | Light: Positive.ornament (#105b2b) Dark: Positive.ornament (#85d898) | | CSS light / dark: `--sds-color-semantic-component-positive-ornament` SCSS light: `$sds-color-semantic-component-positive-ornament` SCSS dark: `$sds-color-semantic-component-positive-ornament-dark` |
489
+
490
+ #### Text
491
+
492
+ The positive *text* variable is used whenever text needs to communicate a Positive intent.
493
+
494
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variable** |
495
+ | --- | --- | --- | --- | --- |
496
+ | text-positive | | Light: Text.positive (#105b2b) Dark: Text.positive (#85d898) | | CSS light / dark: `--sds-color-semantic-component-positive-text` SCSS light: `$sds-color-semantic-component-positive-text` SCSS dark: `$sds-color-semantic-component-positive-text-dark` |
497
+
498
+ ## Primitive Colors
499
+
500
+ ## Color Overview
501
+
502
+ SDS uses a pragmatic naming system for its color variables that ensures consistency around how colors are used across UI elements. Colors are split into three types—Primitive, Semantic, and Visualization—and two modes—Light and Dark (Visualization Colors are currently only available in Light Mode); see Theming for more details about implementing Dark Mode.
503
+
504
+ Primitive Colors are base variables that tie directly to hex codes whereas Semantic Colors take these Primitive Color variables and map them to new variables that are specific to UI elements, intents, and states. Visualization Colormaps are specifically for use in data visualizations.
505
+
506
+ ## Primitive Colors
507
+
508
+ The most basic color elements in the design system are Primitive Colors. They are organized by hue into different ramps and saved as variables within the codebase; each ramp is composed of a range of color variables from light to dark within that color hue (e.g., *blue800*, *blue700*, *blue600*, etc.).
509
+
510
+ Primitive Color variables are **not** intended to be used on their own and are instead mapped to Semantic Color variables that communicate how a Primitive Color is applied to different elements in the design system. This helps ensure the colors are applied consistently and removes the guess work for designers and engineers as to which colors should be used where when designing and building features.
511
+
512
+ ### Light
513
+
514
+ Storybook
515
+
516
+ ### Dark
517
+
518
+ Storybook
519
+
520
+ ## Visualization Colors
521
+
522
+ ## Color Overview
523
+
524
+ SDS uses a pragmatic naming system for its color variables that ensures consistency around how colors are used across UI elements. Colors are split into three types—Primitive, Semantic, and Visualization—and two modes—Light and Dark (Visualization Colors are currently only available in Light Mode); see Theming for more details about implementing Dark Mode. Primitive Colors are base variables that tie directly to hex codes whereas Semantic Colors take these Primitive Color variables and map them to new variables that are specific to UI elements, intents, and states. Visualization Colormaps are specifically for use in data visualizations.
525
+
526
+ ## Visualization Colormaps
527
+
528
+ Colormaps are an array of colors, generally displayed as a gradient or spectrum, and are used to map datapoints to individual color values. Selecting effective colors to represent datapoints within a data visualization plays a major role in how well users are able to interpret that visualization. There are many factors to consider including the type of data is being represented in the dataset, whether the colors are interpretable for folks with visual deficiencies, and if the colors effectively help communicate the intended data story.
529
+
530
+ >**Note:** Visualization Colors are currently only available for Light Mode. If Visualization Colors need to be used in an application in Dark Mode, we recommend placing a light background behind the visualization element.
531
+
532
+ ### Magma
533
+
534
+ Magma is a well-vetted, industry-standard colormap from Matplotlib and is the first colormap available natively in SDS. It provides an array of colors that designers can confidently use as part of their data visualization work since it is so commonly used in the scientific community. This provides the benefit of recognizability, knowing that scientists are already used to interpreting data with these colors.
535
+
536
+ Magma is perceptually uniform, meaning it has consistent and even changes in brightness and hue across the entire colormap. This ensures the colors that get mapped to each datapoint in a visualization are not only an equivalent distance away from each other technically, but visually appear as such, even for folks with visual accessibility concerns who might have trouble perceiving differences between colors.
537
+
538
+ >**Note:** any color from the Magma colormap can be used in implementation, however the following nine colors have been created as variables for easy use in Figma.
539
+
540
+ | **Name** | | **Figma Variable** | | **CSS / SCSS Variables** |
541
+ | --- | --- | --- | --- | --- |
542
+ | magma900 | | | | [variable to come] |
543
+ | magma800 | | | | [variable to come] |
544
+ | magma700 | | | | [variable to come] |
545
+ | magma600 | | | | [variable to come] |
546
+ | magma500 | | | | [variable to come] |
547
+ | magma400 | | | | [variable to come] |
548
+ | magma300 | | | | [variable to come] |
549
+ | magma200 | | | | [variable to come] |
550
+ | magma100 | | | | [variable to come] |
551
+
552
+ ---
553
+
554
+ Color helps communicate usage and intent while providing brand distinction. Our palette has been selected for meaning, accessibility, and cohesion.
555
+
556
+ ## Primary Colors
557
+
558
+ These are the most frequently used colors in the UI's design. Primary400 is the main brand color and is the default color choice for most interactive elements across the product. Black is featured prominently through headlines and body text with the other shades of Gray and Primary Blue used to help distinguish and differentiate elements throughout the UI.
559
+
560
+ For the sake of specificity, only those colors used in each scale are documented in our design system. 
561
+
562
+ ### Primary Blue
563
+
564
+ ###  Grays
565
+
566
+ ---
567
+
568
+ ## Admonition Colors
569
+
570
+ These colors are used on admonition blocks only and should not be used anywhere else in the UI. Each color should be used for the specific admonition type named.
571
+
572
+ ---
573
+
574
+ ## Code Colors
575
+
576
+ These colors are used in code snippets only and should not be used anywhere else in the UI. Each color should be used for the specific code element type named.
577
+
578
+ ---
579
+
580
+ Color helps communicate usage and intent while providing brand distinction. Our palette has been selected for meaning, accessibility, and cohesion.
581
+
582
+ ## Primary Colors
583
+
584
+ These are the most frequently used colors in the UI's design. Primary400 is the main brand color and is the default color choice for most interactive elements across the product. Black is featured prominently through headlines and body text with the other shades of Gray and Primary Purple used to help distinguish and differentiate elements throughout the UI.
585
+
586
+ ### Primary Purple
587
+
588
+ ###  Grays
589
+
590
+ ---
591
+
592
+ ## Feedback Colors
593
+
594
+ These colors are used for product feedback only, i.e., showing info, success, warnings, and errors. For the sake of specificity, only those colors used in each scale are documented in our design system.
595
+
596
+ ### Info
597
+
598
+ ### Success
599
+
600
+ ### Error
601
+
602
+ ### Warning
603
+
604
+ ---
605
+
606
+ Color helps communicate usage and intent while providing brand distinction. Our palette has been selected for meaning, accessibility, and cohesion.
607
+
608
+ ## Primary Colors
609
+
610
+ These are the most frequently used colors in the UI's design. Primary400 is the main brand color and is the default color choice for most interactive elements across the product. Black is featured prominently through headlines and body text with the other shades of Gray and Primary Blue used to help distinguish and differentiate elements throughout the UI.
611
+
612
+ ### Primary Blue
613
+
614
+ ###  Grays
615
+
616
+ ### Secondary Green
617
+
618
+ ---
619
+
620
+ ## Feedback Colors
621
+
622
+ These colors are used for product feedback only, i.e., showing info, success, warnings, and errors. For the sake of specificity, only those colors used in each scale are documented in our design system.
623
+
624
+ ### Info
625
+
626
+ ### Success
627
+
628
+ ### Error
629
+
630
+ ### Warning
631
+
632
+ ### Beta
633
+