Colors

Colors are a key part of the Massachusetts Design System. Colors show identity, create clear order on the page, and help guide the attention of users.

Brand colors

We chose our color palette to reflect the state’s identity and make sure all digital services are accessible.

General guidelines

All organizations should use the Massachusetts Design System color palette as much as possible. This helps make sure residents experience an accessible and recognizable look, no matter which service they use.

Bay Blue

blue color swatch

Bay Blue is the main brand color. It grounds the color palette and creates a consistent look across products.

Base hex color code: #14558F

Bay Blue interactive colors

Bay Blue color interactive buttons showing default, hover, active, disabled, and focus states.

Interactive hex color codes:

DefaultHoverActiveDisabledFocus border
#14558F

#14558F

#4377A5

#104472

#104472

#0A2B48

#F0F0F0

#F0F0F0

#0088FF

#0088FF

Berkshires Green

green color swatch

Berkshires Green is the accent brand color. It works with Bay Blue to add balance and variety, and it often appears in secondary interface elements.

Base hex color code: #388557

Berkshires Green interactive colors

Berkshires Green color interactive buttons showing default, hover, active, disabled, and focus states.

Interactive hex color codes:

DefaultHoverActiveDisabledFocus border
#32784E

#32784E

#388557

#275D3D

#275D3D

#1C432C

#F0F0F0

#F0F0F0

#0088FF

#0088FF

Duckling Yellow

yellow highlight color swatch

Duckling Yellow is the highlight brand color in the palette. Use it sparingly to draw attention to key information and add warmth and energy to the overall experience.

Base hex color code: #F6C51B

Independence Cranberry

A solid bar in the "Independence Cranberry" color.

Independence cranberry is a supporting brand color in the palette. It is not usually used for interactive elements and is most often used in multicolor graphics.

Base hex color code: #680A1D

Granite Gray

gray color swatch

Granite Gray is the neutral brand color in the palette. Use it as a background color to create contrast and support readability without overpowering the primary or accent colors. This helps those colors stand out as focal points.

Base hex color code: #535353. 

Utility

Utility colors are used to show specific system states and user feedback, such as focus, success, warning, and danger. These colors give clear and consistent signals that help users understand what is happening and how to respond. For example, they can show which input field is active, alert someone to a problem, or confirm that an action was successful.

Because these colors have important meaning, their use is limited and standardized across the system. This helps keep them reliable, accessible, and free from overuse or decorative use, so users can trust what they mean wherever they are used. 

Success Green

success green color swatch

Success Green is used to show positive outcomes, successful actions, or completed processes. It gives a clear and accessible signal that something has gone right. For example, confirming a form submission, showing a success message, or highlighting verified information.

Base hex color code: #24A850

Warning Yellow

warning yellow color swatch

Warning Yellow draws attention to important information that may need caution or action. It signals situations that are not errors but may need user awareness, such as upcoming deadlines, incomplete tasks, or possible issues that need review.

Base hex color code: #F6B622

Danger Red

danger red color swatch

Danger Red is used to show errors, serious issues, or destructive actions. It gives a clear and accessible signal that something has gone wrong or needs immediate attention, such as form errors, system failures, or permanent actions like deleting data.

Base hex color code: #CD0D0D

Focus

focus color demo

Focus highlights interactive elements when they receive keyboard or programmatic focus. It provides a clear visual indicator that helps users understand their location 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, such as “background,” “text,” or “icons,” instead of their appearance. This makes it easier to keep color use consistent and meaningful across designs and code.

Designing with semantic color styles in Figma

Designers who use our Figma libraries can choose from a predefined set of semantic color styles. This helps them stay consistent and meet color contrast accessibility requirements.

Semantic color demo in Figma

Token theme files for developers

We are exploring ways to provide token theme files to make implementation more consistent and efficient. If you have suggestions, use cases, or preferences for how these files should be delivered, please email the design system team. We welcome your feedback.

Help Us Improve Mass.gov  with your feedback

Please do not include personal or contact information.
Feedback