Colors

As a foundational element of the Massachusetts Design System, colors express identity, establish visual hierarchy, and guide attention.

Brand colors

Our color palette was chosen to reflect the state’s identity while ensuring accessibility across all digital services.

General guidelines

All organizations should leverage the Massachusetts Design System color palette to the greatest extent possible. This helps to ensure that residents are presented with an accessible, and recognizable identity, no matter which service they’re interacting with.

Bay Blue

blue color swatch

Bay Blue is the primary brand color that anchors the overall palette and provides a consistent visual foundation across products.

Base hex color code: #14558F

Bay Blue interactive colors

Bay blue button states

Interactive hex color codes:

DefaultHoverActiveDisabledFocus border
#14558F

#14558F

#4377A5

#4377A5

#104472

#104472

#F0F0F0

#F0F0F0

#0088FF

#0088FF

Berkshires Green

green color swatch

Berkshires Green is the accent brand color. It complements Bay Blue by adding balance and variety to the palette, often appearing in secondary interface elements.

Base hex color code: #388557

Berkshires Green interactive colors

Berkshires Green button states

Interactive hex color codes:

DefaultHoverActiveDisabledFocus border
#32784E

#32784E

#388557

#388557

#275D3D

#275D3D

#F0F0F0

#F0F0F0

#0088FF

#0088FF

Duckling Yellow

yellow highlight color swatch

Duckling Yellow is the highlight brand color in the palette. It should be used sparingly to draw attention to key information and bring warmth and energy to the overall experience.

Base hex color code: #F6C51B

Granite Gray

gray color swatch

Granite Gray is the neutral brand color in the palette. It can be used as a background fill to create contrast and support readability without overpowering the primary or accent colors, helping those colors stand out as focal points.

Base hex color code: #535353.  

In addition, there is a Light color way for interactive components.

Granite Gray interactive colors

Light button styles
DefaultHoverActiveDisabledFocus border
#F7F7F7

#F7F7F7

#FFFFFF

#FFFFFF

#E6E6E6

#E6E6E6

#F0F0F0

#F0F0F0

#0088FF

#0088FF

Utility

Utility colors are reserved for conveying specific system states and user feedback such as focus, success, warning, and danger. These colors provide clear, consistent signals that help users understand what’s happening and how to respond, whether it’s identifying the active input field, being alerted to an issue, or confirming a successful action. Because they carry critical meaning across interactions, utility colors are intentionally limited and standardized within the system. This ensures they remain reliable, accessible, and free from visual overload or misuse in decorative contexts, so users can trust their meaning wherever they appear.

Success Green

success green color swatch

Success Green is used to indicate positive outcomes, successful actions, or completed processes. It provides a clear, accessible visual signal that something has gone right, such as confirming a form submission, displaying a success message, or highlighting verified information.

Base hex color code: #24A850

Warning Yellow

warning yellow color swatch

Warning Yellow is used to draw attention to important information that may need caution or action. It signals situations that aren’t errors but could require user awareness, such as upcoming deadlines, incomplete tasks, or potential issues that need to be reviewed.

Base hex color code: #F6B622

Danger Red

danger red color swatch

Danger Red is used to indicate errors, critical issues, or destructive actions. It provides a clear, accessible visual signal that something has gone wrong or needs immediate attention, such as form validation errors, system failures, or irreversible actions like deleting data.

Base hex color code: #CD0D0D

Danger Red interactive colors

Danger red button states
DefaultHoverActiveDisabledFocus border
#CD0D0D

#CD0D0D

#FFFFFF

#FFFFFF

#FEF1F1

#FEF1F1

#F0F0F0

#F0F0F0

#0088FF

#0088FF

Focus

focus color demo

Focus is used to highlight interactive elements when they receive keyboard or programmatic focus. It provides a clear visual indicator to support accessibility and help users understand where they are on the page when navigating without a mouse.

Focus on light
Hex color code: #0088FF

Focus on dark
Hex color code: #B2DBFF
 

Semantic color definition

A semantic color style definition names color styles based on their purpose or role (like “background” "text" or “icons”) rather than their appearance, making it easier to keep color consistent and meaningful across designs and code.

Designing with semantic color styles in Figma

Designers leveraging our Figma libraries, can easily choose from the predefined set of semantic color styles to maintain consistency, and meet color contrast accessibility requirements.

Semantic color demo in Figma

View the color style definitions in Figma

All semantic color styles were created using our base (also known as primitive) color ramp variables.

View the color base tokens

Token theme files for developers

We’re currently exploring options for providing token theme files to make implementation more consistent and efficient. If you have suggestions, use cases, or preferences for how these files could be delivered, please send an email to designsystem@mass.gov. We'd love to connect and hear your input.

Help Us Improve Mass.gov  with your feedback

Please do not include personal or contact information.
Feedback