@adobe/spectrum-design-data 3.3.0 → 3.4.0

package/guidelines/layout-spacing.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
+  "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/layout-spacing.json",
+  "name": "layout-spacing",
+  "title": "Layout spacing",
+  "category": "designing",
+  "documentBlocks": [
+    { "type": "purpose", "content": "Layout spacing" },
+    {
+      "type": "guideline",
+      "content": "Layout spacing governs object relationships, such as the spacing between components, patterns, and regions of a UI. It’s implemented through global tokens, which follow a geometric progression with values that round to familiar numbers: 2, 4, 8, 16. If you're used to an 8 px grid, these will feel recognizable. The scale provides consistent perceptual difference between adjacent values across its full range. Image: Scale of gray squares increasing in size from left to right, labeled with values 1, 2, 4, 6, 8, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, and 96, with a dotted diagonal line showing the growth curve. (source: https://spectrum.adobe.com/foundations/layout-and-structure/spacing/media_115ea12e4cac857c4b8d7fccac0293a81ae114447.png?width=750&format=png&optimize=medium)"
+    },
+    {
+      "type": "guideline",
+      "content": "Global tokens govern object relationships in a layout. They create and distinguish the relationships between the components that make up a product UI. Smaller values create tighter relationships. Larger values create more visual independence. The choice should reflect the actual relationship between the objects being spaced. Image: Screenshot of the Adobe GenStudio interface showing a top navigation bar with a search field, a green table icon with a loading placeholder bar, and a floating toolbar with icons for image approval, comment, \"Cr,\" and a highlighted gold icon; two callouts label the horizontal bands as \"spacing-100\" and \"spacing-250.\" (source: https://spectrum.adobe.com/foundations/layout-and-structure/spacing/media_1a16efb69dea68171c4c4dcbcff449b7c21eaa2ad.png?width=750&format=png&optimize=medium)"
+    },
+    {
+      "type": "guideline",
+      "content": "A common approach to spacing is to pick a base unit and build all spacing values from its multiples, such as 8, 16, 24, 32. These values are familiar and easy to remember, which is part of their appeal. This approach is called a linear progression. Linear progressions like this work well in many situations, but have two limitations. First, spacing needs to grow with the elements around it. A 4 px gap between an icon and label looks right in a small component, but as the component scales up, the nearest grid values (4 px or 8 px) no longer fit the relationship correctly. Second, linear scales lose differentiation at larger values. The difference between 4 px and 8 px is obvious. The difference between 72 px and 80 px is almost imperceptible. Image: Scale of gray squares increasing in size from left to right beneath a pink upward curve, with a bracket over the first two squares labeled \"100% increase\" and a bracket over the last two squares labeled \"11% increase,\" illustrating a decelerating growth rate. (source: https://spectrum.adobe.com/foundations/layout-and-structure/spacing/media_10c237cd90839604eca53c6ac170d7cf2f3812435.png?width=750&format=png&optimize=medium) Both of these limitations come down to the same underlying cause: human perception doesn't measure space in fixed increments. Spectrum's spacing system is built around geometric progressions and semantic tokens to address this directly. The next page explains how."
+    },
+    {
+      "type": "guideline",
+      "content": "Use global tokens for layout spacing. Token Value spacing-25 1px spacing-50 2px spacing-75 4px spacing-85 6px spacing-100 8px spacing-200 12px spacing-300 16px spacing-350 20px spacing-400 24px spacing-500 32px spacing-600 40px spacing-700 48px spacing-750 56px spacing-800 64px spacing-900 80px spacing-1000 96px"
+    }
+  ],
+  "sourceUrl": "https://spectrum.adobe.com/foundations/layout-and-structure/spacing/layout-spacing",
+  "lastUpdated": "2026-08-13",
+  "status": "published",
+  "tags": [
+    "layout spacing",
+    "global tokens",
+    "geometric progression",
+    "semantic tokens",
+    "8 px grid",
+    "linear progression",
+    "perceptual spacing",
+    "spacing scale"
+  ]
+}

package/guidelines/manifest.json

@@ -1,5 +1,13 @@
 {
   "guidelines": [
+    {
+      "slug": "ai-resource-guide",
+      "title": "AI resource guide",
+      "category": "support",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/support/ai-resource-guide",
+      "file": "guidelines/ai-resource-guide.json"
+    },
     {
       "slug": "app-frame-content-area",
       "title": "App frame content area (browsing context)",
@@ -29,7 +37,7 @@
       "title": "App frame",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/app-frame-overview/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/app-frame/overview",
       "file": "guidelines/app-frame-overview.json"
     },
     {
@@ -40,12 +48,20 @@
       "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/app-frame-side-navigation/",
       "file": "guidelines/app-frame-side-navigation.json"
     },
+    {
+      "slug": "applying-the-type-system",
+      "title": "Applying the type system",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/typography/applying-the-type-system",
+      "file": "guidelines/applying-the-type-system.json"
+    },
     {
       "slug": "attention-hierarchy",
       "title": "Attention hierarchy",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/attention-hierarchy/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/attention-hierarchy",
       "file": "guidelines/attention-hierarchy.json"
     },
     {
@@ -53,47 +69,119 @@
       "title": "Background layers",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/background-layers/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/color/background-layers",
       "file": "guidelines/background-layers.json"
     },
+    {
+      "slug": "bi-directionality",
+      "title": "Bi-directionality",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/inclusivity/bi-directionality",
+      "file": "guidelines/bi-directionality.json"
+    },
+    {
+      "slug": "border-width",
+      "title": "Border width",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/styles/object-styles/border-width",
+      "file": "guidelines/border-width.json"
+    },
     {
       "slug": "brand",
       "title": "Brand",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/brand/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/brand",
       "file": "guidelines/brand.json"
     },
+    {
+      "slug": "cognitive",
+      "title": "Cognitive",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://main--spectrum-hub--adobe.aem.live/foundations/inclusivity/cognitive",
+      "file": "guidelines/cognitive.json"
+    },
     {
       "slug": "colors",
       "title": "Colors",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/colors/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/color/colors",
       "file": "guidelines/colors.json"
     },
+    {
+      "slug": "component-spacing",
+      "title": "Component spacing",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/layout-and-structure/spacing/component-spacing",
+      "file": "guidelines/component-spacing.json"
+    },
+    {
+      "slug": "contact-us",
+      "title": "Contact us",
+      "category": "support",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/support/contact-us",
+      "file": "guidelines/contact-us.json"
+    },
     {
       "slug": "containers",
       "title": "Containers",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/containers/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/layout-and-structure/containers",
       "file": "guidelines/containers.json"
     },
+    {
+      "slug": "content-area-browsing-context",
+      "title": "Browsing context: Content area",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/app-frame/content-area-browsing-context",
+      "file": "guidelines/content-area-browsing-context.json"
+    },
+    {
+      "slug": "creating-bluelines-browsing-context",
+      "title": "Creating bluelines",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/app-frame/creating-bluelines-browsing-context",
+      "file": "guidelines/creating-bluelines-browsing-context.json"
+    },
+    {
+      "slug": "design-tokens",
+      "title": "Design tokens",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/design-data/design-tokens",
+      "file": "guidelines/design-tokens.json"
+    },
     {
       "slug": "developer-overview",
       "title": "Developer overview",
       "category": "developing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/developer-overview/",
+      "sourceUrl": "https://main--spectrum-hub--adobe.aem.live/support/developer-overview",
       "file": "guidelines/developer-overview.json"
     },
+    {
+      "slug": "drop-shadow",
+      "title": "Drop shadow",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/styles/object-styles/drop-shadow",
+      "file": "guidelines/drop-shadow.json"
+    },
     {
       "slug": "faqs",
       "title": "FAQs",
       "category": "support",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/faqs/",
+      "sourceUrl": "https://main--spectrum-hub--adobe.aem.live/support/faqs",
       "file": "guidelines/faqs.json"
     },
     {
@@ -101,25 +189,49 @@
       "title": "Fonts",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/fonts/",
+      "sourceUrl": "https://main--spectrum-hub--adobe.aem.live/foundations/typography/fonts",
       "file": "guidelines/fonts.json"
     },
+    {
+      "slug": "grammar-and-mechanics",
+      "title": "Grammar and mechanics",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/grammar-and-mechanics",
+      "file": "guidelines/grammar-and-mechanics.json"
+    },
     {
       "slug": "grays",
       "title": "Grays",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/grays/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/color/grays",
       "file": "guidelines/grays.json"
     },
+    {
+      "slug": "header-browsing-context",
+      "title": "Browsing context: Header",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/app-frame/header-browsing-context",
+      "file": "guidelines/header-browsing-context.json"
+    },
     {
       "slug": "icon-fundamentals",
       "title": "Icon fundamentals",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/icon-fundamentals/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/icons-and-illustrations/icon-fundamentals",
       "file": "guidelines/icon-fundamentals.json"
     },
+    {
+      "slug": "illustration",
+      "title": "Illustration",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/icons-and-illustrations/illustration",
+      "file": "guidelines/illustration.json"
+    },
     {
       "slug": "illustrations",
       "title": "Illustrations",
@@ -128,6 +240,38 @@
       "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/illustrations/",
       "file": "guidelines/illustrations.json"
     },
+    {
+      "slug": "in-product-word-list",
+      "title": "In-product word list",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/in-product-word-list",
+      "file": "guidelines/in-product-word-list.json"
+    },
+    {
+      "slug": "inclusive-design",
+      "title": "Inclusive design",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/inclusivity/inclusive-design",
+      "file": "guidelines/inclusive-design.json"
+    },
+    {
+      "slug": "inclusive-ux-writing",
+      "title": "Inclusive UX writing",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/language-and-inclusivity/inclusive-ux-writing",
+      "file": "guidelines/inclusive-ux-writing.json"
+    },
+    {
+      "slug": "internationalization",
+      "title": "Internationalization",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/inclusivity/internationalization",
+      "file": "guidelines/internationalization.json"
+    },
     {
       "slug": "introduction",
       "title": "Introduction",
@@ -136,12 +280,20 @@
       "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/introduction/",
       "file": "guidelines/introduction.json"
     },
+    {
+      "slug": "layout-spacing",
+      "title": "Layout spacing",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/layout-and-structure/spacing/layout-spacing",
+      "file": "guidelines/layout-spacing.json"
+    },
     {
       "slug": "motion",
       "title": "Motion",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/motion/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/behavior/motion",
       "file": "guidelines/motion.json"
     },
     {
@@ -152,12 +304,20 @@
       "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/object-styles/",
       "file": "guidelines/object-styles.json"
     },
+    {
+      "slug": "object-styles-overview",
+      "title": "Object styles",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/styles/object-styles/overview",
+      "file": "guidelines/object-styles-overview.json"
+    },
     {
       "slug": "principles",
       "title": "Principles",
       "category": "fundamentals",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/principles/",
+      "sourceUrl": "https://spectrum.adobe.com/getting-started/principles",
       "file": "guidelines/principles.json"
     },
     {
@@ -165,9 +325,25 @@
       "title": "Resources",
       "category": "support",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/resources/",
+      "sourceUrl": "https://main--spectrum-hub--adobe.aem.live/support/resources",
       "file": "guidelines/resources.json"
     },
+    {
+      "slug": "rounding",
+      "title": "Rounding",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/styles/object-styles/rounding",
+      "file": "guidelines/rounding.json"
+    },
+    {
+      "slug": "side-navigation-browsing-context",
+      "title": "Browsing context: Side nav",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/app-frame/side-navigation-browsing-context",
+      "file": "guidelines/side-navigation-browsing-context.json"
+    },
     {
       "slug": "spacing",
       "title": "Spacing",
@@ -176,14 +352,30 @@
       "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/spacing/",
       "file": "guidelines/spacing.json"
     },
+    {
+      "slug": "spacing-overview",
+      "title": "Spacing",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/layout-and-structure/spacing/overview",
+      "file": "guidelines/spacing-overview.json"
+    },
     {
       "slug": "states",
       "title": "States",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/states/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/behavior/states",
       "file": "guidelines/states.json"
     },
+    {
+      "slug": "support",
+      "title": "FAQs",
+      "category": "support",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/support",
+      "file": "guidelines/support.json"
+    },
     {
       "slug": "typography-fundamentals",
       "title": "Typography fundamentals",
@@ -192,13 +384,85 @@
       "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/typography-fundamentals/",
       "file": "guidelines/typography-fundamentals.json"
     },
+    {
+      "slug": "typography-overview",
+      "title": "Typography",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/typography/overview",
+      "file": "guidelines/typography-overview.json"
+    },
+    {
+      "slug": "typography-system",
+      "title": "Typography system",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/typography/typography-system",
+      "file": "guidelines/typography-system.json"
+    },
     {
       "slug": "using-icons",
       "title": "Using icons",
       "category": "designing",
       "status": "published",
-      "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/using-icons/",
+      "sourceUrl": "https://spectrum.adobe.com/foundations/icons-and-illustrations/using-icons",
       "file": "guidelines/using-icons.json"
+    },
+    {
+      "slug": "voice-and-tone",
+      "title": "Voice and tone",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/voice-and-tone",
+      "file": "guidelines/voice-and-tone.json"
+    },
+    {
+      "slug": "whats-new",
+      "title": "A new home for Spectrum",
+      "category": "fundamentals",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/getting-started/whats-new",
+      "file": "guidelines/whats-new.json"
+    },
+    {
+      "slug": "writing-about-people",
+      "title": "Writing about people",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/language-and-inclusivity/writing-about-people",
+      "file": "guidelines/writing-about-people.json"
+    },
+    {
+      "slug": "writing-for-errors",
+      "title": "Writing for errors",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/writing-for-errors",
+      "file": "guidelines/writing-for-errors.json"
+    },
+    {
+      "slug": "writing-for-onboarding",
+      "title": "Writing for onboarding",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/writing-for-onboarding",
+      "file": "guidelines/writing-for-onboarding.json"
+    },
+    {
+      "slug": "writing-for-readability",
+      "title": "Writing for readability",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/language-and-inclusivity/writing-for-readability",
+      "file": "guidelines/writing-for-readability.json"
+    },
+    {
+      "slug": "writing-with-visuals",
+      "title": "Writing with visuals",
+      "category": "designing",
+      "status": "published",
+      "sourceUrl": "https://spectrum.adobe.com/content/language-and-inclusivity/writing-with-visuals",
+      "file": "guidelines/writing-with-visuals.json"
     }
   ]
 }

package/guidelines/motion.json

@@ -7,35 +7,40 @@
   "documentBlocks": [
     {
       "type": "purpose",
-      "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."
+      "content": "Spectrum 2 builds on top of the Spectrum 1 motion guidelines for the design system: 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. Motion 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. Motion in Spectrum 2 is categorized into the areas of directional motion, interaction motion, and wayfinding motion. Wayfinding motion is still in development."
     },
     {
       "type": "guideline",
-      "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."
+      "content": "The directions in which motion happens communicate intentional meanings. There are three basic categories of directional motion, each used for their own purpose."
     },
     {
       "type": "guideline",
-      "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."
+      "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. If you’re creating a custom animation, consider RTL (right-to-left) languages and also how the meaning of motion might differ depending on cultural context. Progress bars communicate forward progression. They work well to show determinate (finite) progress. Image: A labeled progress bar reading \"Progress bar label,\" approximately 60% filled in blue with the remaining portion shown in gray. (source: https://spectrum.adobe.com/foundations/behavior/media_1410ad434da4df2e5f27e65cb39cf6e9dd762b988.png?width=750&format=png&optimize=medium) Image: A labeled progress bar reading \"Progress bar label,\" fully filled in blue from end to end, indicating 100% completion. (source: https://spectrum.adobe.com/foundations/behavior/media_1976d0b4d46d779f561e43f584769fcdb1ee46257.png?width=750&format=png&optimize=medium) In this 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. Image: A black pill-shaped 'Next' button with a right arrow icon, shown with a cursor positioned just below it, before hover. (source: https://spectrum.adobe.com/foundations/behavior/media_13c1db2becccdae3e3c51faee90f9f0f7223a79ee.png?width=750&format=png&optimize=medium) Image: The same black 'Next' button, now with the cursor positioned directly on top of it in a hover or click state. (source: https://spectrum.adobe.com/foundations/behavior/media_13780e91120d63ef14c91f7ca97c5e88d49481814.png?width=750&format=png&optimize=medium)"
     },
     {
       "type": "guideline",
-      "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."
+      "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. In this 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. Image: Text reading 'For more information, visit the Adobe Help Center' with the link underlined in blue and a diagonal external-link arrow, cursor positioned below the link, before hover. (source: https://spectrum.adobe.com/foundations/behavior/media_16efc4fe0b70604bccaff2a9935bfcd487b64a73e.png?width=750&format=png&optimize=medium) Image: The same 'Adobe Help Center' link, now with the cursor positioned directly on the link text in a hover state. (source: https://spectrum.adobe.com/foundations/behavior/media_1824800b0d2b9ce2e5980fe39e3d526807ab0b7a5.png?width=750&format=png&optimize=medium)"
     },
     {
       "type": "guideline",
-      "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."
+      "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. Progress circles have clockwise motion and work well to show indeterminate (infinite) progress. Image: A circular progress indicator on a light gray background, showing roughly 20% complete in blue against a gray track. (source: https://spectrum.adobe.com/foundations/behavior/media_1113e169705ecbd524e5b138be65b9a4e595aaf6f.png?width=750&format=png&optimize=medium) Image: A circular progress indicator on a light gray background, showing roughly 85% complete in blue against a gray track. (source: https://spectrum.adobe.com/foundations/behavior/media_1aa94bf6842145f9e11edf213d92ede35aeab5324.png?width=750&format=png&optimize=medium)"
     },
     {
       "type": "guideline",
-      "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."
-    },
-    {
-      "type": "guideline",
-      "content": "In this example, the button scales down on the down state, emphasizing that something — the action of selecting — happened."
+      "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. A microinteraction 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. In this example, the button scales down on the down state, emphasizing that something — the action of selecting — happened. Image: A black pill-shaped button labeled 'Button,' with a cursor positioned below it, before interaction. (source: https://spectrum.adobe.com/foundations/behavior/media_1912db9847e2a13fa026399336088aadc29ab9886.png?width=750&format=png&optimize=medium) Image: The same 'Button' element, slightly larger and darker with a pointer/hand cursor overlapping its bottom edge, indicating a pressed or clicked state. (source: https://spectrum.adobe.com/foundations/behavior/media_16bedff0632adae2a74753d9064814716b15c1265.png?width=750&format=png&optimize=medium)"
     }
   ],
-  "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/motion/",
-  "lastUpdated": "2026-02-02",
+  "sourceUrl": "https://spectrum.adobe.com/foundations/behavior/motion",
+  "lastUpdated": "2026-09-04",
   "status": "published",
-  "tags": ["designing"]
+  "tags": [
+    "Motion",
+    "Directional motion",
+    "Linear motion",
+    "Diagonal motion",
+    "Clockwise motion",
+    "Interaction motion",
+    "Wayfinding motion",
+    "Microinteractions"
+  ]
 }

package/guidelines/object-styles-overview.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/guideline.schema.json",
+  "$id": "https://opensource.adobe.com/spectrum-design-data/guidelines/object-styles-overview.json",
+  "name": "object-styles-overview",
+  "title": "Object styles",
+  "category": "designing",
+  "documentBlocks": [
+    {
+      "type": "purpose",
+      "content": "Spectrum’s object styles include rounding, border width, and drop shadow. Object styles are combined with color in different ways to communicate specific cues about interactions, adding a layer of meaning to the style of components. For example, different types of inputs all share styles. Search fields, text fields, and combo boxes use object styles to communicate 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. Image: Wireframe comparison of three form control categories — Text input (search field, text field, dropdown), Selection (button, dropdown menu, dropdown menu), and Binary selection (radio buttons, checkboxes, toggle switches) — each shown in unselected and selected states. (source: https://spectrum.adobe.com/foundations/styles/object-styles/media_17ff0c24745d8692c51ff3e23285f23e24844313c.png?width=750&format=png&optimize=medium)\n\n### Jump to\n\nImage: Four corner brackets arranged in a square formation illustrating corner rounding, with the top-right corner highlighted in a blue-to-teal gradient. (source: https://spectrum.adobe.com/foundations/styles/object-styles/media_1ca22cd57315c5e0ec18a85ef74211e5c2f683177.png?width=750&format=png&optimize=medium) Rounding Rounding Image: Three horizontal pill-shaped bars illustrating different border width styles: a thin gradient outline, a thicker soft-edged border, and a wide blurred border. (source: https://spectrum.adobe.com/foundations/styles/object-styles/media_1f2b7a2b6809ec86f7eab36c3ab90fcd7f31bd677.png?width=750&format=png&optimize=medium) Border width Border width Image: A rounded square outline with a soft drop shadow next to a diagonal rounded line in a pink-to-purple gradient, illustrating drop shadow styling. (source: https://spectrum.adobe.com/foundations/styles/object-styles/media_17d32a2b3be83c7c4f7541a166559a90e9683c24d.png?width=750&format=png&optimize=medium) Drop shadow Drop shadow"
+    }
+  ],
+  "sourceUrl": "https://spectrum.adobe.com/foundations/styles/object-styles/overview",
+  "lastUpdated": "2026-08-14",
+  "status": "published",
+  "tags": ["Object styles", "Rounding", "Border width", "Drop shadow"]
+}

package/guidelines/principles.json

@@ -8,23 +8,22 @@
     { "type": "purpose", "content": "Principles" },
     {
       "type": "guideline",
-      "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."
+      "content": "Spectrum is based on real-world situations. Every component, pattern, and principle is informed by thoughtful consideration of environments, applications, and range of needs that Adobe products serve. Spectrum 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."
     },
     {
       "type": "guideline",
-      "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."
+      "content": "Spectrum places people's needs first. It's deeply committed to a high standard of inclusivity, accessibility, honesty, and respect. Spectrum 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. Image: Aperture/lens icon representing the Focused principle (source: https://spectrum.adobe.com/getting-started/media_1d733c7a6b8739373a7b68306edb74b7c2ffe34b4.png?width=750&format=png&optimize=medium) Image: Two overlapping speech bubbles representing the Collaborative principle (source: https://spectrum.adobe.com/getting-started/media_1289706018f1e7799026af8a56beeec33c163c2ee.png?width=750&format=png&optimize=medium)"
     },
     {
       "type": "guideline",
-      "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."
+      "content": "Spectrum delivers what's needed, when it's needed. Every decoration is purposeful and meaningful. Every communication touchpoint is relevant. Spectrum 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."
     },
     {
       "type": "guideline",
-      "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."
+      "content": "Spectrum belongs to everyone. It's a reflection of an ever-growing community that makes decisions thoughtfully, holistically, and collectively. Spectrum examines from multiple angles, then refines, then repeats. Constantly."
     }
   ],
-  "sourceUrl": "https://s2.spectrum.corp.adobe.com/page/principles/",
-  "lastUpdated": "2026-02-02",
-  "status": "published",
-  "tags": ["fundamentals"]
+  "sourceUrl": "https://spectrum.adobe.com/getting-started/principles",
+  "lastUpdated": "2026-09-10",
+  "status": "published"
 }