@adobe/spectrum-design-data 0.3.0 → 0.6.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 (99) hide show
  1. package/LICENSE +1 -1
  2. package/components/accordion.json +108 -194
  3. package/components/action-bar.json +64 -97
  4. package/components/action-button.json +95 -230
  5. package/components/action-group.json +88 -86
  6. package/components/alert-banner.json +104 -76
  7. package/components/alert-dialog.json +78 -126
  8. package/components/avatar-group.json +61 -119
  9. package/components/avatar.json +98 -212
  10. package/components/badge.json +138 -256
  11. package/components/breadcrumbs.json +95 -89
  12. package/components/button-group.json +57 -48
  13. package/components/button.json +151 -368
  14. package/components/calendar.json +97 -34
  15. package/components/cards.json +109 -250
  16. package/components/checkbox-group.json +50 -58
  17. package/components/checkbox.json +121 -186
  18. package/components/close-button.json +61 -124
  19. package/components/coach-indicator.json +63 -72
  20. package/components/coach-mark.json +89 -93
  21. package/components/color-area.json +68 -94
  22. package/components/color-handle.json +39 -79
  23. package/components/color-loupe.json +35 -52
  24. package/components/color-slider.json +95 -116
  25. package/components/color-wheel.json +67 -73
  26. package/components/combo-box.json +243 -331
  27. package/components/contextual-help.json +86 -175
  28. package/components/date-picker.json +139 -179
  29. package/components/divider.json +30 -69
  30. package/components/drop-zone.json +51 -92
  31. package/components/field-label.json +75 -117
  32. package/components/help-text.json +81 -105
  33. package/components/illustrated-message.json +106 -73
  34. package/components/in-line-alert.json +50 -83
  35. package/components/link.json +63 -85
  36. package/components/list-view.json +107 -146
  37. package/components/menu.json +180 -274
  38. package/components/meter.json +72 -118
  39. package/components/number-field.json +213 -305
  40. package/components/picker.json +208 -320
  41. package/components/popover.json +94 -129
  42. package/components/progress-bar.json +94 -131
  43. package/components/progress-circle.json +45 -72
  44. package/components/radio-button.json +87 -156
  45. package/components/radio-group.json +107 -74
  46. package/components/rating.json +66 -99
  47. package/components/search-field.json +132 -202
  48. package/components/segmented-control.json +94 -109
  49. package/components/select-box.json +119 -179
  50. package/components/side-navigation.json +108 -118
  51. package/components/slider.json +143 -228
  52. package/components/standard-dialog.json +96 -114
  53. package/components/standard-panel.json +105 -53
  54. package/components/status-light.json +104 -240
  55. package/components/steplist.json +77 -161
  56. package/components/swatch-group.json +42 -58
  57. package/components/swatch.json +75 -162
  58. package/components/switch.json +101 -189
  59. package/components/table.json +97 -102
  60. package/components/tabs.json +77 -104
  61. package/components/tag-field.json +86 -150
  62. package/components/tag-group.json +50 -44
  63. package/components/tag.json +81 -198
  64. package/components/takeover-dialog.json +59 -57
  65. package/components/text-area.json +200 -323
  66. package/components/text-field.json +183 -304
  67. package/components/thumbnail.json +63 -105
  68. package/components/toast.json +97 -83
  69. package/components/tooltip.json +104 -96
  70. package/components/tree-view.json +169 -181
  71. package/guidelines/app-frame-content-area.json +87 -0
  72. package/guidelines/app-frame-creating-bluelines.json +61 -0
  73. package/guidelines/app-frame-header.json +75 -0
  74. package/guidelines/app-frame-overview.json +167 -0
  75. package/guidelines/app-frame-side-navigation.json +138 -0
  76. package/guidelines/attention-hierarchy.json +42 -0
  77. package/guidelines/background-layers.json +41 -0
  78. package/guidelines/brand.json +50 -0
  79. package/guidelines/colors.json +65 -0
  80. package/guidelines/containers.json +65 -0
  81. package/guidelines/developer-overview.json +38 -0
  82. package/guidelines/faqs.json +35 -0
  83. package/guidelines/fonts.json +58 -0
  84. package/guidelines/grays.json +69 -0
  85. package/guidelines/icon-fundamentals.json +45 -0
  86. package/guidelines/illustrations.json +114 -0
  87. package/guidelines/introduction.json +34 -0
  88. package/guidelines/manifest.json +204 -0
  89. package/guidelines/motion.json +41 -0
  90. package/guidelines/object-styles.json +105 -0
  91. package/guidelines/principles.json +30 -0
  92. package/guidelines/resources.json +59 -0
  93. package/guidelines/spacing.json +25 -0
  94. package/guidelines/states.json +34 -0
  95. package/guidelines/typography-fundamentals.json +145 -0
  96. package/guidelines/using-icons.json +110 -0
  97. package/package.json +5 -2
  98. package/tokens/layout-component.tokens.json +72 -36
  99. package/tokens/layout.tokens.json +207 -92
@@ -0,0 +1,204 @@
1
+ {
2
+ "guidelines": [
3
+ {
4
+ "slug": "app-frame-content-area",
5
+ "title": "App frame content area (browsing context)",
6
+ "category": "designing",
7
+ "status": "published",
8
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/app-frame-content-area/",
9
+ "file": "guidelines/app-frame-content-area.json"
10
+ },
11
+ {
12
+ "slug": "app-frame-creating-bluelines",
13
+ "title": "Creating bluelines (browsing context)",
14
+ "category": "designing",
15
+ "status": "published",
16
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/app-frame-creating-bluelines/",
17
+ "file": "guidelines/app-frame-creating-bluelines.json"
18
+ },
19
+ {
20
+ "slug": "app-frame-header",
21
+ "title": "App frame header (browsing context)",
22
+ "category": "designing",
23
+ "status": "published",
24
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/app-frame-header/",
25
+ "file": "guidelines/app-frame-header.json"
26
+ },
27
+ {
28
+ "slug": "app-frame-overview",
29
+ "title": "App frame",
30
+ "category": "designing",
31
+ "status": "published",
32
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/app-frame-overview/",
33
+ "file": "guidelines/app-frame-overview.json"
34
+ },
35
+ {
36
+ "slug": "app-frame-side-navigation",
37
+ "title": "App frame side navigation (browsing context)",
38
+ "category": "designing",
39
+ "status": "published",
40
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/app-frame-side-navigation/",
41
+ "file": "guidelines/app-frame-side-navigation.json"
42
+ },
43
+ {
44
+ "slug": "attention-hierarchy",
45
+ "title": "Attention hierarchy",
46
+ "category": "designing",
47
+ "status": "published",
48
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/attention-hierarchy/",
49
+ "file": "guidelines/attention-hierarchy.json"
50
+ },
51
+ {
52
+ "slug": "background-layers",
53
+ "title": "Background layers",
54
+ "category": "designing",
55
+ "status": "published",
56
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/background-layers/",
57
+ "file": "guidelines/background-layers.json"
58
+ },
59
+ {
60
+ "slug": "brand",
61
+ "title": "Brand",
62
+ "category": "designing",
63
+ "status": "published",
64
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/brand/",
65
+ "file": "guidelines/brand.json"
66
+ },
67
+ {
68
+ "slug": "colors",
69
+ "title": "Colors",
70
+ "category": "designing",
71
+ "status": "published",
72
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/colors/",
73
+ "file": "guidelines/colors.json"
74
+ },
75
+ {
76
+ "slug": "containers",
77
+ "title": "Containers",
78
+ "category": "designing",
79
+ "status": "published",
80
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/containers/",
81
+ "file": "guidelines/containers.json"
82
+ },
83
+ {
84
+ "slug": "developer-overview",
85
+ "title": "Developer overview",
86
+ "category": "developing",
87
+ "status": "published",
88
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/developer-overview/",
89
+ "file": "guidelines/developer-overview.json"
90
+ },
91
+ {
92
+ "slug": "faqs",
93
+ "title": "FAQs",
94
+ "category": "support",
95
+ "status": "published",
96
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/faqs/",
97
+ "file": "guidelines/faqs.json"
98
+ },
99
+ {
100
+ "slug": "fonts",
101
+ "title": "Fonts",
102
+ "category": "designing",
103
+ "status": "published",
104
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/fonts/",
105
+ "file": "guidelines/fonts.json"
106
+ },
107
+ {
108
+ "slug": "grays",
109
+ "title": "Grays",
110
+ "category": "designing",
111
+ "status": "published",
112
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/grays/",
113
+ "file": "guidelines/grays.json"
114
+ },
115
+ {
116
+ "slug": "icon-fundamentals",
117
+ "title": "Icon fundamentals",
118
+ "category": "designing",
119
+ "status": "published",
120
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/icon-fundamentals/",
121
+ "file": "guidelines/icon-fundamentals.json"
122
+ },
123
+ {
124
+ "slug": "illustrations",
125
+ "title": "Illustrations",
126
+ "category": "designing",
127
+ "status": "published",
128
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/illustrations/",
129
+ "file": "guidelines/illustrations.json"
130
+ },
131
+ {
132
+ "slug": "introduction",
133
+ "title": "Introduction",
134
+ "category": "fundamentals",
135
+ "status": "published",
136
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/introduction/",
137
+ "file": "guidelines/introduction.json"
138
+ },
139
+ {
140
+ "slug": "motion",
141
+ "title": "Motion",
142
+ "category": "designing",
143
+ "status": "published",
144
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/motion/",
145
+ "file": "guidelines/motion.json"
146
+ },
147
+ {
148
+ "slug": "object-styles",
149
+ "title": "Object styles",
150
+ "category": "designing",
151
+ "status": "published",
152
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/object-styles/",
153
+ "file": "guidelines/object-styles.json"
154
+ },
155
+ {
156
+ "slug": "principles",
157
+ "title": "Principles",
158
+ "category": "fundamentals",
159
+ "status": "published",
160
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/principles/",
161
+ "file": "guidelines/principles.json"
162
+ },
163
+ {
164
+ "slug": "resources",
165
+ "title": "Resources",
166
+ "category": "support",
167
+ "status": "published",
168
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/resources/",
169
+ "file": "guidelines/resources.json"
170
+ },
171
+ {
172
+ "slug": "spacing",
173
+ "title": "Spacing",
174
+ "category": "designing",
175
+ "status": "published",
176
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/spacing/",
177
+ "file": "guidelines/spacing.json"
178
+ },
179
+ {
180
+ "slug": "states",
181
+ "title": "States",
182
+ "category": "designing",
183
+ "status": "published",
184
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/states/",
185
+ "file": "guidelines/states.json"
186
+ },
187
+ {
188
+ "slug": "typography-fundamentals",
189
+ "title": "Typography fundamentals",
190
+ "category": "designing",
191
+ "status": "published",
192
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/typography-fundamentals/",
193
+ "file": "guidelines/typography-fundamentals.json"
194
+ },
195
+ {
196
+ "slug": "using-icons",
197
+ "title": "Using icons",
198
+ "category": "designing",
199
+ "status": "published",
200
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/using-icons/",
201
+ "file": "guidelines/using-icons.json"
202
+ }
203
+ ]
204
+ }
@@ -0,0 +1,41 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/motion.json",
4
+ "name": "motion",
5
+ "title": "Motion",
6
+ "category": "designing",
7
+ "documentBlocks": [
8
+ {
9
+ "type": "purpose",
10
+ "content": "Spectrum 2 builds on top of the [existing motion guidelines for the design system](https://spectrum.corp.adobe.com/page/motion/): that motion is always purposeful, intuitive, and seamless. With this update, we also use motion to draw attention to areas where we want to add personality. No matter what, the usage of motion should be adding meaning to an experience. And, motion over large surface areas needs to support browser and system settings for reduced motion.\n\nMotion is also an important part of brand expression. Just like tone in language, tone in motion can range from formal and direct to lighthearted and subtle.\n\nMotion in Spectrum 2 is categorized into the areas of **directional** motion, **interaction** motion, and **wayfinding** motion. Wayfinding motion is still in development."
11
+ },
12
+ {
13
+ "type": "guideline",
14
+ "content": "Linear motion indicates forward movement and a sentiment of progress. When emphasizing movement to a different section, page, or item (such as a button or link), the destination is readily clear and minimally disruptive.\n\nIf you're creating a custom animation, consider [RTL (right-to-left) languages](https://spectrum.corp.adobe.com/page/bi-directionality/) and also how the meaning of motion might differ depending on cultural context.\n\nProgress bars communicate forward progression. They work well to show determinate (finite) progress.\n\nIn the example of a button, a static arrow icon facing toward the right already indicates forward movement. When linear motion is added to the arrow upon hover, the movement is emphasized. Use this button option with motion sparingly, only on the most important action(s) on a page."
15
+ },
16
+ {
17
+ "type": "guideline",
18
+ "content": "Diagonal motion indicates larger movement, and can be potentially disruptive. This type of motion can be used to emphasize that there's a switch in context happening, like linking out to a different view or destination.\n\nIn the example of a link, a static arrow icon facing the top right already indicates a potentially disruptive action. When diagonal motion is added to the arrow on hover, the meaning of the arrow is emphasized. Use this link option with motion sparingly, and only to communicate that there will be a switch in context."
19
+ },
20
+ {
21
+ "type": "guideline",
22
+ "content": "Clockwise motion indicates a holding pattern that's repetitive and doesn't have clear forward momentum or progress. This is most often used for loading indicators.\n\nProgress circles have clockwise motion and work well to show indeterminate (infinite) progress."
23
+ },
24
+ {
25
+ "type": "guideline",
26
+ "content": "Motion shows users feedback that, when interacting with the UI, their actions are registering with a system. It's not the only way to show feedback, but it helps objects to feel more dynamic and responsive. It also can help communicate meaning, or add emphasis that something is happening that requires attention."
27
+ },
28
+ {
29
+ "type": "guideline",
30
+ "content": "A [microinteraction](https://www.nngroup.com/articles/microinteractions/) is a single action (like a click, tap, or swipe) which triggers a response (like a transition or animation). In Spectrum 2, microinteractions offer moments of personality that are reflective of product branding."
31
+ },
32
+ {
33
+ "type": "guideline",
34
+ "content": "In this example, the button scales down on the down state, emphasizing that something — the action of selecting — happened."
35
+ }
36
+ ],
37
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/motion/",
38
+ "lastUpdated": "2026-02-02",
39
+ "status": "published",
40
+ "tags": ["designing"]
41
+ }
@@ -0,0 +1,105 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/object-styles.json",
4
+ "name": "object-styles",
5
+ "title": "Object styles",
6
+ "category": "designing",
7
+ "documentBlocks": [
8
+ {
9
+ "type": "purpose",
10
+ "content": "Example of how object styles are combined to communicate different interactions.\n\nIn general, Spectrum 2’s system for rounding is more pronounced and flexible than in Spectrum 1.\n\nIn general, this system of rounding creates a visually balanced gap when nesting smaller objects within larger objects.\n\n\"There are two border widths used within in-product UI contexts:\"\n\n\"The third option is not used within in-product UI contexts:\"\n\nA medium divider separates two action button groups. Note that when dividers are used with visible gaps on both ends, the end caps are fully rounded.\n\nWhile the detailed values are still in progress, the foundational concepts for drop shadows still apply.\n\n\"In Spectrum 2, shadows are composed of three layers: a key shadow, an ambient shadow, and a transition shadow that’s between them.\"\n\nContainers that appear on top of content, such as menus and tooltips, have drop shadows to show elevation."
11
+ },
12
+ {
13
+ "type": "guideline",
14
+ "content": "Object styles are specific visual shapes or effects that are used to communicate intent or to give cues about an interaction."
15
+ },
16
+ {
17
+ "type": "guideline",
18
+ "content": "For example, different types of inputs all share styles. Search fields, text fields, and combo boxes use object styles to communicate a primary purpose: text input. A search field is often more of a global scope, and has full rounding to add emphasis and differentiation from other types of fields. Action buttons, pickers, and in-field buttons share a fill color to indicate selection. Checkboxes, radio buttons, and switches share object styles to indicate binary selection."
19
+ },
20
+ {
21
+ "type": "guideline",
22
+ "content": "Example of how object styles are combined to communicate different interactions."
23
+ },
24
+ {
25
+ "type": "guideline",
26
+ "content": "In general, Spectrum 2’s system for rounding is more pronounced and flexible than in Spectrum 1."
27
+ },
28
+ {
29
+ "type": "guideline",
30
+ "content": "Larger rounding values give components more expression and personality, and having more rounding options makes it possible to create visual balance across a wide range of contexts."
31
+ },
32
+ {
33
+ "type": "guideline",
34
+ "content": "In general, this system of rounding creates a visually balanced gap when nesting smaller objects within larger objects."
35
+ },
36
+ {
37
+ "type": "guideline",
38
+ "content": "Avatars are displayed in circles to draw attention to user content. All other representations, such as groups and products, are displayed in rounded squares."
39
+ },
40
+ {
41
+ "type": "guideline",
42
+ "content": "In Spectrum 2, rounding for different sized components varies based on a Major Second logarithmic scale. This allows for components to retain a consistent and identifiable shape at all sizes. Desktop and mobile scales share the same base rounding. Note that the values displayed are base values for desktop scale components, and specific corner radius values may vary between components."
43
+ },
44
+ {
45
+ "type": "guideline",
46
+ "content": "Borders are only used when spacing isn’t enough to show separation. For example, a divider might sometimes be needed to separate two distinct action button groups. Or, an object might have a border to demarcate distinct areas, such as separating a panel or card from the rest of the content on a page."
47
+ },
48
+ {
49
+ "type": "guideline",
50
+ "content": "There are two border widths used within in-product UI contexts:"
51
+ },
52
+ {
53
+ "type": "guideline",
54
+ "content": "The third option is not used within in-product UI contexts:"
55
+ },
56
+ {
57
+ "type": "guideline",
58
+ "content": "A medium divider separates two action button groups. Note that when dividers are used with visible gaps on both ends, the end caps are fully rounded."
59
+ },
60
+ {
61
+ "type": "guideline",
62
+ "content": "In Spectrum 2, large borders are only used in longform content, such as in documentation pages. Large borders aren’t used within in-product UI contexts."
63
+ },
64
+ {
65
+ "type": "guideline",
66
+ "content": "A full-width medium divider can be a helpful option for separating two distinct parts of a page, such as dividing a navigation panel from the rest of the content. When deciding whether a divider is needed, consider whether groups of information are still clear without one. Generally, more complex content with a varying alignment of objects will benefit the most from using a divider."
67
+ },
68
+ {
69
+ "type": "guideline",
70
+ "content": "Similarly to the previous example, a full-width medium divider separates a commenting panel from the rest of the page. The divider is helpful in this context since the commenting panel can have varying content, from an empty state to many layers of nested comments. By creating a clear boundary, this helps set expectations for what content is presented in the panel."
71
+ },
72
+ {
73
+ "type": "guideline",
74
+ "content": "Drop shadows draw attention and give the appearance of depth. By default, this style is used to show elevation, when content appears on top of other content."
75
+ },
76
+ {
77
+ "type": "guideline",
78
+ "content": "While the detailed values are still in progress, the foundational concepts for drop shadows still apply."
79
+ },
80
+ {
81
+ "type": "guideline",
82
+ "content": "In Spectrum 2, shadows are composed of three layers: a key shadow, an ambient shadow, and a transition shadow that’s between them."
83
+ },
84
+ {
85
+ "type": "guideline",
86
+ "content": "Containers that appear on top of content, such as menus and tooltips, have drop shadows to show elevation."
87
+ },
88
+ {
89
+ "type": "guideline",
90
+ "content": "By default, objects have no drop shadows. When a container is dragged, a drop shadow is used to show elevation in both default and emphasized containers."
91
+ },
92
+ {
93
+ "type": "guideline",
94
+ "content": "An overlay represents elevation in a different way: it focuses attention on the content above the overlay only. When using an overlay (for example, behind a dialog), no additional drop shadow is applied to the background."
95
+ }
96
+ ],
97
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/object-styles/",
98
+ "lastUpdated": "2026-02-02",
99
+ "status": "published",
100
+ "tags": ["designing"],
101
+ "related": [
102
+ { "ref": "fonts", "kind": "guideline" },
103
+ { "ref": "spacing", "kind": "guideline" }
104
+ ]
105
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/principles.json",
4
+ "name": "principles",
5
+ "title": "Principles",
6
+ "category": "fundamentals",
7
+ "documentBlocks": [
8
+ { "type": "purpose", "content": "Principles" },
9
+ {
10
+ "type": "guideline",
11
+ "content": "Rational.\n\nSpectrum is based on real-world situations. Every component, pattern, and principle is informed by thoughtful testing. Every decision is backed by thorough interdisciplinary research.\n\nSpectrum is not a rigid set of rules for how to build products, but rather a set of adaptable resources for making experiences feel contextual, cohesive, and performant."
12
+ },
13
+ {
14
+ "type": "guideline",
15
+ "content": "Human.\n\nSpectrum places people's needs first. It's deeply committed to a high standard of inclusivity, accessibility, honesty, and respect.\n\nSpectrum is adaptable to meet as many user expectations, platform requirements, and product visions as possible. It's always what it needs to be, accommodating a flexible range of expression. It balances the human needs of utility and joy."
16
+ },
17
+ {
18
+ "type": "guideline",
19
+ "content": "Focused.\n\nSpectrum delivers what's needed, when it's needed. Every decoration is purposeful and meaningful. Every communication touchpoint is relevant.\n\nSpectrum experiences are built to a high standard of quality. Everything incorporates attention to details, and that creates experiences that look and feel well-crafted. Things are delightful to use because they balance functionality and expression."
20
+ },
21
+ {
22
+ "type": "guideline",
23
+ "content": "Collaborative.\n\nSpectrum belongs to everyone. It's a reflection of an ever-growing community that makes decisions thoughtfully, holistically, and collectively.\n\nSpectrum examines from multiple angles, then refines, then repeats. Constantly."
24
+ }
25
+ ],
26
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/principles/",
27
+ "lastUpdated": "2026-02-02",
28
+ "status": "published",
29
+ "tags": ["fundamentals"]
30
+ }
@@ -0,0 +1,59 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/resources.json",
4
+ "name": "resources",
5
+ "title": "Resources",
6
+ "category": "support",
7
+ "documentBlocks": [
8
+ { "type": "purpose", "content": "Resources" },
9
+ {
10
+ "type": "guideline",
11
+ "content": "The Spectrum 2 Figma libraries are the primary resource for Spectrum 2 components, styles, and variables. These libraries are stable, so you can use the designs in production."
12
+ },
13
+ {
14
+ "type": "guideline",
15
+ "content": "An example of the Spectrum 2 library: the action button page."
16
+ },
17
+ {
18
+ "type": "guideline",
19
+ "content": "This GitHub repository houses Spectrum’s design tokens, which are primarily name-value pairs used to store design decisions and distributed in a way that platforms, implementations, and products can use across design tools and coding languages."
20
+ },
21
+ {
22
+ "type": "guideline",
23
+ "content": "This tool allows you to search for token names or values, filter values by scale and theme, and explore the relationship between Spectrum’s tokens by selecting tokens to see their connections."
24
+ },
25
+ {
26
+ "type": "guideline",
27
+ "content": "To support this transition, S2/Color has been removed from the inheritance chain in the Figma libraries. Designers should update their files to replace color styles with color variables. Following the steps in the guide will help ensure your files remain stable and aligned with the Spectrum system moving forward."
28
+ },
29
+ {
30
+ "type": "guideline",
31
+ "content": "These changes are for Spectrum 2 libraries. They do not apply to Spectrum 1."
32
+ },
33
+ {
34
+ "type": "guideline",
35
+ "content": "To support the new font, we’ve updated our default line-height values and introduced symmetrical vertical padding token values to our design system. The Spectrum 2 typography guide includes details about what’s changing, what’s staying the same, and options for updating design files or implementations."
36
+ },
37
+ {
38
+ "type": "guideline",
39
+ "content": "These changes are for Spectrum 2 libraries and implementations. They do not apply to Spectrum 1 components."
40
+ },
41
+ {
42
+ "type": "guideline",
43
+ "content": "Spectrum 2 includes two new grays — gray-25 and gray-1000 — plus an update to the rest of the 11 grays. The migration guide goes into more detail about what’s changing and what’s staying the same."
44
+ },
45
+ {
46
+ "type": "guideline",
47
+ "content": "Creating interfaces that support right-to-left (RTL) and bi-directional (Bidi) languages is essential to ensuring that our products are inclusive of global audiences. These guides, created by the Adobe International team, offer comprehensive frameworks on how to design and build for both web and mobile components."
48
+ },
49
+ {
50
+ "type": "guideline",
51
+ "content": "The Adobe Design Brand team has created Spectrum 2-inspired desktop and mobile backgrounds for you to download."
52
+ }
53
+ ],
54
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/resources/",
55
+ "lastUpdated": "2026-02-02",
56
+ "status": "published",
57
+ "tags": ["support"],
58
+ "related": [{ "ref": "contact" }]
59
+ }
@@ -0,0 +1,25 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/spacing.json",
4
+ "name": "spacing",
5
+ "title": "Spacing",
6
+ "category": "designing",
7
+ "documentBlocks": [
8
+ {
9
+ "type": "purpose",
10
+ "content": "Spectrum 2 continues with Spectrum's current guidelines for spacing and responsive grids. More detailed guidelines for responsive design are currently in progress.\n\nThe primary update for Spectrum 2 is that **instead of dividers, spacing is used as the primary way to group and divide content**. Different spacing values establish rhythm and create hierarchy within a page. The [spacing values](https://spectrum.corp.adobe.com/page/spacing/#Spacing-values) themselves remain unchanged from Spectrum 1.\n\nSmaller spacing values should generally be used for objects that are closely related. An example of this would be to use a smaller spacing value in between the components that make up a component group, like in a button group or a group of cards.\n\nLarger spacing values should be used for groups of things that are less closely related. An example of this would be to use a larger spacing value to separate two distinct sections of content. Doing this helps to better organize a page.\n\nIn some contexts, a divider can still be appropriate to define larger areas of a page. View more about [border width](https://s2.spectrum.corp.adobe.com/page/object-styles/#border-width).\n\n### Example\n\nIn this example, the side navigation items use a smaller spacing value (spacing-75) in order to show a closer relationship. The side navigation items are grouped with a combination of a section title and a larger spacing value (spacing-400) to divide two distinct sections.\n\nSimilarly, cards that are part of the same group have a smaller spacing value (spacing-300) between them. Each group of cards has a title and a larger spacing value (spacing-500) to show two that the two groups are distinct.\n\nBy using spacing intentionally, the purpose of page content becomes more readily apparent and information can become easier to parse."
11
+ },
12
+ {
13
+ "type": "guideline",
14
+ "content": "Spectrum defines density as the spacing between components or UI elements, regardless of their size and scale. Density can be used alongside component size to create a range of layouts, from spacious to dense."
15
+ },
16
+ {
17
+ "type": "guideline",
18
+ "content": "For example, when creating complex UI layouts, high density is often combined with smaller components and tighter spacing in between elements."
19
+ }
20
+ ],
21
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/spacing/",
22
+ "lastUpdated": "2026-02-02",
23
+ "status": "published",
24
+ "tags": ["designing"]
25
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/states.json",
4
+ "name": "states",
5
+ "title": "States",
6
+ "category": "designing",
7
+ "documentBlocks": [
8
+ { "type": "purpose", "content": "States" },
9
+ {
10
+ "type": "guideline",
11
+ "content": "In Spectrum 2, some components use a change in size instead of color to communicate a down state. This gives the illusion of objects being pressed-in, and makes interactions more dynamic and responsive."
12
+ },
13
+ {
14
+ "type": "guideline",
15
+ "content": "[Disabled states](https://spectrum.corp.adobe.com/page/states/#Disabled) generally stay the same from Spectrum 1, but there have been some minor updates to specific components. For example, a text field retains the outline style when disabled, to more closely match its default state."
16
+ },
17
+ {
18
+ "type": "guideline",
19
+ "content": "Selected states use a primary style by default, generally through a gray-800 fill. Some have an accent color option that can be used to draw emphasis. This is primarily helpful in contexts with a specific and narrowly-scoped goal (for example, in a dialog), or when there's a single, clear call to action within a page (for example, a \"Create\" button)."
20
+ },
21
+ {
22
+ "type": "guideline",
23
+ "content": "When there's many groups of controls that require the same amount of attention (such as in a panel) the not emphasized option works best. For more details about this concept, view [Attention hierarchy](https://s2.spectrum.corp.adobe.com/page/attention-hierarchy/)."
24
+ },
25
+ {
26
+ "type": "guideline",
27
+ "content": "A dragged state has a unique drop shadow to draw attention to the dragged object. Learn more about [drop shadows](https://s2.spectrum.corp.adobe.com/page/object-styles/#drop-shadow)."
28
+ }
29
+ ],
30
+ "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/states/",
31
+ "lastUpdated": "2026-02-02",
32
+ "status": "published",
33
+ "tags": ["designing"]
34
+ }