Updates a design system for a project. Use this tool when the user wants to change the overall visual theme, style, or branding of the application.
This includes configuring:
- Color Palette: Presets, custom primary colors, and saturation levels.
- Typography: Font families (e.g., Inter, Roboto, etc.).
- Shape: Corner roundness for UI elements.
- Appearance: Light and dark mode background colors.
- Design MD: Free-form design instructions in markdown.
This tool establishes the foundational design tokens that apply across all screens in the project.
View input schema
{
"type": "object",
"properties": {
"designSystem": {
"$ref": "#/$defs/DesignSystem",
"description": "Required. The design system to update."
},
"name": {
"description": "Required. Identifier. The resource name of the design system to update. Format: `assets/{asset_id}` Example: `assets/15996705518239280238`",
"type": "string",
"x-google-identifier": true
},
"projectId": {
"description": "Required. The project ID to update design system for, example: '4044680601076201931', without the `projects/` prefix.",
"type": "string"
}
},
"required": [
"name",
"projectId",
"designSystem"
],
"$defs": {
"DesignSystem": {
"description": "Represents a collection of guidelines, design tokens, and reusable components that define the visual and functional characteristics of a product's design. This is used to guide the generation of consistent and branded designs. LINT.IfChange",
"properties": {
"displayName": {
"description": "Required. Specifies the display name of the design system.",
"type": "string"
},
"theme": {
"$ref": "#/$defs/DesignTheme",
"description": "Required. Specifies the theme of the design system."
}
},
"required": [
"displayName",
"theme"
],
"type": "object"
},
"DesignTheme": {
"description": "The theme of the design. Next ID: 15 LINT.IfChange",
"properties": {
"bodyFont": {
"description": "Required. Specifies the body font.",
"enum": [
"FONT_UNSPECIFIED",
"BE_VIETNAM_PRO",
"EPILOGUE",
"INTER",
"LEXEND",
"MANROPE",
"NEWSREADER",
"NOTO_SERIF",
"PLUS_JAKARTA_SANS",
"PUBLIC_SANS",
"SPACE_GROTESK",
"SPLINE_SANS",
"WORK_SANS",
"DOMINE",
"LIBRE_CASLON_TEXT",
"EB_GARAMOND",
"LITERATA",
"SOURCE_SERIF_4",
"SOURCE_SERIF_FOUR",
"MONTSERRAT",
"METROPHOBIC",
"METROPOLIS",
"SOURCE_SANS_3",
"SOURCE_SANS_THREE",
"NUNITO_SANS",
"ARIMO",
"HANKEN_GROTESK",
"RUBIK",
"GEIST",
"DM_SANS",
"IBM_PLEX_SANS",
"SORA",
"ANYBODY",
"ANTON",
"ARCHIVO_NARROW",
"ATKINSON_HYPERLEGIBLE_NEXT",
"BARLOW_CONDENSED",
"BEBAS_NEUE",
"BODONI_MODA",
"BRICOLAGE_GROTESQUE",
"CHIVO",
"CLIMATE_CRISIS",
"COMFORTAA",
"COURIER_PRIME",
"FIRA_SANS",
"GOOGLE_SANS",
"GOOGLE_SANS_CODE",
"GOOGLE_SANS_FLEX",
"GOOGLE_SANS_MONO",
"GOOGLE_SANS_TEXT",
"IBM_PLEX_SERIF",
"JETBRAINS_MONO",
"KARLA",
"LIBRE_FRANKLIN",
"MERRIWEATHER",
"NOTO_SANS",
"OPEN_SANS",
"OSWALD",
"OUTFIT",
"PLAYFAIR_DISPLAY",
"POIRET_ONE",
"QUESTRIAL",
"QUICKSAND",
"RALEWAY",
"ROBOTO_FLEX",
"SPACE_MONO",
"SYNE",
"VOLLKORN"
],
"type": "string",
"x-google-enum-deprecated": [
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
true,
false,
false,
true,
false,
true,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false
],
"x-google-enum-descriptions": [
"Unspecified font.",
"Be Vietnam Pro font.",
"Epilogue font.",
"Inter font.",
"Lexend font.",
"Manrope font.",
"Newsreader font.",
"Noto Serif font.",
"Plus Jakarta Sans font.",
"Public Sans font.",
"Space Grotesk font.",
"Spline Sans font.",
"Work Sans font.",
"Domine font.",
"Libre Caslon Text font.",
"EB Garamond font.",
"Literata font.",
"Source Serif 4 font.",
"Source Serif 4 font. Deprecated.",
"Montserrat font.",
"The Metrophobic font.",
"Metropolis font. Deprecated.",
"The Source Sans 3 font.",
"Source Sans 3 font. Deprecated.",
"Nunito Sans font.",
"Arimo font.",
"Hanken Grotesk font.",
"Rubik font.",
"Geist font.",
"DM Sans font.",
"IBM Plex Sans font.",
"Sora font.",
"Anybody font.",
"Anton font.",
"Archivo Narrow font.",
"Atkinson Hyperlegible Next font.",
"Barlow Condensed font.",
"Bebas Neue font.",
"Bodoni Moda font.",
"Bricolage Grotesque font.",
"Chivo font.",
"Climate Crisis font.",
"Comfortaa font.",
"Courier Prime font.",
"Fira Sans font.",
"Google Sans font.",
"Google Sans Code font.",
"Google Sans Flex font.",
"Google Sans Mono font.",
"Google Sans Text font.",
"IBM Plex Serif font.",
"JetBrains Mono font.",
"Karla font.",
"Libre Franklin font.",
"Merriweather font.",
"Noto Sans font.",
"Open Sans font.",
"Oswald font.",
"Outfit font.",
"Playfair Display font.",
"Poiret One font.",
"Questrial font.",
"Quicksand font.",
"Raleway font.",
"Roboto Flex font.",
"Space Mono font.",
"Syne font.",
"Vollkorn font."
]
},
"colorMode": {
"description": "Required. Specifies the mode of appearance of the design.",
"enum": [
"COLOR_MODE_UNSPECIFIED",
"LIGHT",
"DARK"
],
"type": "string",
"x-google-enum-descriptions": [
"Unspecified color mode.",
"Light mode.",
"Dark mode."
]
},
"colorVariant": {
"description": "Optional. Specifies the variant of the dynamic color system.",
"enum": [
"COLOR_VARIANT_UNSPECIFIED",
"MONOCHROME",
"NEUTRAL",
"TONAL_SPOT",
"VIBRANT",
"EXPRESSIVE",
"FIDELITY",
"CONTENT",
"RAINBOW",
"FRUIT_SALAD"
],
"type": "string",
"x-google-enum-descriptions": [
"Unspecified color variant.",
"Monochrome variant.",
"Neutral variant.",
"Tonal spot variant.",
"Vibrant variant.",
"Expressive variant.",
"Fidelity variant.",
"Content variant.",
"Rainbow variant.",
"Fruit salad variant."
]
},
"customColor": {
"description": "Required. Specifies a custom theme primary color, or a seed color for the dynamic color system (hex format, e.g., \"#ff0000\").",
"type": "string"
},
"designMd": {
"description": "Optional. Specifies a markdown file that describes the design system.",
"type": "string"
},
"headlineFont": {
"description": "Required. Specifies the headline font.",
"enum": [
"FONT_UNSPECIFIED",
"BE_VIETNAM_PRO",
"EPILOGUE",
"INTER",
"LEXEND",
"MANROPE",
"NEWSREADER",
"NOTO_SERIF",
"PLUS_JAKARTA_SANS",
"PUBLIC_SANS",
"SPACE_GROTESK",
"SPLINE_SANS",
"WORK_SANS",
"DOMINE",
"LIBRE_CASLON_TEXT",
"EB_GARAMOND",
"LITERATA",
"SOURCE_SERIF_4",
"SOURCE_SERIF_FOUR",
"MONTSERRAT",
"METROPHOBIC",
"METROPOLIS",
"SOURCE_SANS_3",
"SOURCE_SANS_THREE",
"NUNITO_SANS",
"ARIMO",
"HANKEN_GROTESK",
"RUBIK",
"GEIST",
"DM_SANS",
"IBM_PLEX_SANS",
"SORA",
"ANYBODY",
"ANTON",
"ARCHIVO_NARROW",
"ATKINSON_HYPERLEGIBLE_NEXT",
"BARLOW_CONDENSED",
"BEBAS_NEUE",
"BODONI_MODA",
"BRICOLAGE_GROTESQUE",
"CHIVO",
"CLIMATE_CRISIS",
"COMFORTAA",
"COURIER_PRIME",
"FIRA_SANS",
"GOOGLE_SANS",
"GOOGLE_SANS_CODE",
"GOOGLE_SANS_FLEX",
"GOOGLE_SANS_MONO",
"GOOGLE_SANS_TEXT",
"IBM_PLEX_SERIF",
"JETBRAINS_MONO",
"KARLA",
"LIBRE_FRANKLIN",
"MERRIWEATHER",
"NOTO_SANS",
"OPEN_SANS",
"OSWALD",
"OUTFIT",
"PLAYFAIR_DISPLAY",
"POIRET_ONE",
"QUESTRIAL",
"QUICKSAND",
"RALEWAY",
"ROBOTO_FLEX",
"SPACE_MONO",
"SYNE",
"VOLLKORN"
],
"type": "string",
"x-google-enum-deprecated": [
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
true,
false,
false,
true,
false,
true,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false
],
"x-google-enum-descriptions": [
"Unspecified font.",
"Be Vietnam Pro font.",
"Epilogue font.",
"Inter font.",
"Lexend font.",
"Manrope font.",
"Newsreader font.",
"Noto Serif font.",
"Plus Jakarta Sans font.",
"Public Sans font.",
"Space Grotesk font.",
"Spline Sans font.",
"Work Sans font.",
"Domine font.",
"Libre Caslon Text font.",
"EB Garamond font.",
"Literata font.",
"Source Serif 4 font.",
"Source Serif 4 font. Deprecated.",
"Montserrat font.",
"The Metrophobic font.",
"Metropolis font. Deprecated.",
"The Source Sans 3 font.",
"Source Sans 3 font. Deprecated.",
"Nunito Sans font.",
"Arimo font.",
"Hanken Grotesk font.",
"Rubik font.",
"Geist font.",
"DM Sans font.",
"IBM Plex Sans font.",
"Sora font.",
"Anybody font.",
"Anton font.",
"Archivo Narrow font.",
"Atkinson Hyperlegible Next font.",
"Barlow Condensed font.",
"Bebas Neue font.",
"Bodoni Moda font.",
"Bricolage Grotesque font.",
"Chivo font.",
"Climate Crisis font.",
"Comfortaa font.",
"Courier Prime font.",
"Fira Sans font.",
"Google Sans font.",
"Google Sans Code font.",
"Google Sans Flex font.",
"Google Sans Mono font.",
"Google Sans Text font.",
"IBM Plex Serif font.",
"JetBrains Mono font.",
"Karla font.",
"Libre Franklin font.",
"Merriweather font.",
"Noto Sans font.",
"Open Sans font.",
"Oswald font.",
"Outfit font.",
"Playfair Display font.",
"Poiret One font.",
"Questrial font.",
"Quicksand font.",
"Raleway font.",
"Roboto Flex font.",
"Space Mono font.",
"Syne font.",
"Vollkorn font."
]
},
"labelFont": {
"description": "Optional. Specifies the label font.",
"enum": [
"FONT_UNSPECIFIED",
"BE_VIETNAM_PRO",
"EPILOGUE",
"INTER",
"LEXEND",
"MANROPE",
"NEWSREADER",
"NOTO_SERIF",
"PLUS_JAKARTA_SANS",
"PUBLIC_SANS",
"SPACE_GROTESK",
"SPLINE_SANS",
"WORK_SANS",
"DOMINE",
"LIBRE_CASLON_TEXT",
"EB_GARAMOND",
"LITERATA",
"SOURCE_SERIF_4",
"SOURCE_SERIF_FOUR",
"MONTSERRAT",
"METROPHOBIC",
"METROPOLIS",
"SOURCE_SANS_3",
"SOURCE_SANS_THREE",
"NUNITO_SANS",
"ARIMO",
"HANKEN_GROTESK",
"RUBIK",
"GEIST",
"DM_SANS",
"IBM_PLEX_SANS",
"SORA",
"ANYBODY",
"ANTON",
"ARCHIVO_NARROW",
"ATKINSON_HYPERLEGIBLE_NEXT",
"BARLOW_CONDENSED",
"BEBAS_NEUE",
"BODONI_MODA",
"BRICOLAGE_GROTESQUE",
"CHIVO",
"CLIMATE_CRISIS",
"COMFORTAA",
"COURIER_PRIME",
"FIRA_SANS",
"GOOGLE_SANS",
"GOOGLE_SANS_CODE",
"GOOGLE_SANS_FLEX",
"GOOGLE_SANS_MONO",
"GOOGLE_SANS_TEXT",
"IBM_PLEX_SERIF",
"JETBRAINS_MONO",
"KARLA",
"LIBRE_FRANKLIN",
"MERRIWEATHER",
"NOTO_SANS",
"OPEN_SANS",
"OSWALD",
"OUTFIT",
"PLAYFAIR_DISPLAY",
"POIRET_ONE",
"QUESTRIAL",
"QUICKSAND",
"RALEWAY",
"ROBOTO_FLEX",
"SPACE_MONO",
"SYNE",
"VOLLKORN"
],
"type": "string",
"x-google-enum-deprecated": [
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
true,
false,
false,
true,
false,
true,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false
],
"x-google-enum-descriptions": [
"Unspecified font.",
"Be Vietnam Pro font.",
"Epilogue font.",
"Inter font.",
"Lexend font.",
"Manrope font.",
"Newsreader font.",
"Noto Serif font.",
"Plus Jakarta Sans font.",
"Public Sans font.",
"Space Grotesk font.",
"Spline Sans font.",
"Work Sans font.",
"Domine font.",
"Libre Caslon Text font.",
"EB Garamond font.",
"Literata font.",
"Source Serif 4 font.",
"Source Serif 4 font. Deprecated.",
"Montserrat font.",
"The Metrophobic font.",
"Metropolis font. Deprecated.",
"The Source Sans 3 font.",
"Source Sans 3 font. Deprecated.",
"Nunito Sans font.",
"Arimo font.",
"Hanken Grotesk font.",
"Rubik font.",
"Geist font.",
"DM Sans font.",
"IBM Plex Sans font.",
"Sora font.",
"Anybody font.",
"Anton font.",
"Archivo Narrow font.",
"Atkinson Hyperlegible Next font.",
"Barlow Condensed font.",
"Bebas Neue font.",
"Bodoni Moda font.",
"Bricolage Grotesque font.",
"Chivo font.",
"Climate Crisis font.",
"Comfortaa font.",
"Courier Prime font.",
"Fira Sans font.",
"Google Sans font.",
"Google Sans Code font.",
"Google Sans Flex font.",
"Google Sans Mono font.",
"Google Sans Text font.",
"IBM Plex Serif font.",
"JetBrains Mono font.",
"Karla font.",
"Libre Franklin font.",
"Merriweather font.",
"Noto Sans font.",
"Open Sans font.",
"Oswald font.",
"Outfit font.",
"Playfair Display font.",
"Poiret One font.",
"Questrial font.",
"Quicksand font.",
"Raleway font.",
"Roboto Flex font.",
"Space Mono font.",
"Syne font.",
"Vollkorn font."
]
},
"overrideNeutralColor": {
"description": "Optional. Overrides the neutral color for the dynamic color system (hex format, e.g., \"#ffffff\").",
"type": "string"
},
"overridePrimaryColor": {
"description": "Optional. Overrides the primary color for the dynamic color system (hex format, e.g., \"#ff0000\").",
"type": "string"
},
"overrideSecondaryColor": {
"description": "Optional. Overrides the secondary color for the dynamic color system (hex format, e.g., \"#00ff00\").",
"type": "string"
},
"overrideTertiaryColor": {
"description": "Optional. Overrides the tertiary color for the dynamic color system (hex format, e.g., \"#0000ff\").",
"type": "string"
},
"roundness": {
"description": "Required. Specifies the roundness of the design. Supported values are: \"ROUND_FOUR\", \"ROUND_EIGHT\", and \"ROUND_TWELVE\", and \"ROUND_FULL\".",
"enum": [
"ROUNDNESS_UNSPECIFIED",
"ROUND_TWO",
"ROUND_FOUR",
"ROUND_EIGHT",
"ROUND_TWELVE",
"ROUND_FULL"
],
"type": "string",
"x-google-enum-deprecated": [
false,
true,
false,
false,
false,
false
],
"x-google-enum-descriptions": [
"Unspecified roundness.",
"Round 2. Unused.",
"Round 4.",
"Round 8.",
"Round 12 or full",
"Round full."
]
},
"spacing": {
"additionalProperties": {
"type": "string"
},
"description": "Optional. Spacing units for the design system. Maps spacing names to their values.",
"type": "object"
},
"typography": {
"additionalProperties": {
"$ref": "#/$defs/Typography"
},
"description": "Optional. Typography scale for the design system. Maps level names (e.g. \"display-lg\", \"body-md\") to their Typography token.",
"type": "object"
}
},
"required": [
"colorMode",
"headlineFont",
"bodyFont",
"roundness",
"customColor"
],
"type": "object"
},
"Typography": {
"description": "A typography style token in a design system, defining the visual properties for a single text level (e.g. \"display-lg\", \"body-md\").",
"properties": {
"fontFamily": {
"description": "Optional. The CSS font-family value (e.g., \"Manrope\", \"Inter\").",
"type": "string"
},
"fontSize": {
"description": "Optional. The CSS font-size value (e.g., \"32px\", \"1rem\").",
"type": "string"
},
"fontWeight": {
"description": "Optional. The CSS font-weight value (e.g., \"400\", \"700\").",
"type": "string"
},
"letterSpacing": {
"description": "Optional. The CSS letter-spacing value (e.g., \"0px\", \"-0.02em\").",
"type": "string"
},
"lineHeight": {
"description": "Optional. The CSS line-height value (e.g., \"1.5\", \"40px\").",
"type": "string"
}
},
"type": "object"
}
},
"description": "Request message for UpdateDesignSystem."
}