Design Tokens
Color
#154973
Color Theme
Primary brand color. Used for primary actions and interactive elements like buttons, checkboxes, and agency-specific headers and footers. Overridden by agency-specific themes.
--nys-color-theme
#0e324f
Color Theme Strong
Stronger shade of theme color, used for hover state on interactive elements. Overridden by agency-specific themes.
--nys-color-theme-strong
#081b2b
Color Theme Stronger
Strongest shade of theme color, used for pressed state on interactive elements. Overridden by agency-specific themes.
--nys-color-theme-stronger
#457aa5
Color Theme Mid
Mid-range shade of theme color. Use sparingly, since text contrast against this color is problematic. Overridden by agency-specific themes.
--nys-color-theme-mid
#cddde9
Color Theme Weak
Slightly lighter shade of theme color. Overridden by agency-specific themes.
--nys-color-theme-weak
#eff6fb
Color Theme Weaker
Lighter shade of theme color, used to subtly convey brand in places with a lot of text, like the global agency footer. Overridden by agency-specific themes.
--nys-color-theme-weaker
#f7fafd
Color Theme Faint
Faint shade of the theme color. Good for subtle accents or backgrounds. Overridden by agency-specific themes.
--nys-color-theme-faint
#face00
Color Accent
Bold accent color for highlighting or emphasis. Use sparingly, especially in application contexts where it can be confused with warning or error colors.
--nys-color-accent
#004dd1
Color Info
Informational color for neutral messages.
--nys-color-info
#e5effa
Color Info Weak
Used as a background for informational contexts with a lot of text, like alerts.
--nys-color-info-weak
#1e752e
Color Success
Used to communicate successful actions or states.
--nys-color-success
#e8f1ea
Color Success Weak
Used as a background for success contexts with a lot of text, like alerts.
--nys-color-success-weak
#face00
Color Warning
Used as a warning color for non-critical alerts.
--nys-color-warning
#fefae5
Color Warning Weak
Used as a background for warning contexts with a lot of text, like alerts.
--nys-color-warning-weak
#b52c2c
Color Danger
Used to indicate destructive actions or failures.
--nys-color-danger
#f7eaea
Color Danger Weak
Used as a background in destructive or error contexts with a lot of text, like alerts.
--nys-color-danger-weak
#dodoce
Color Base
Base color for supplementary informational messages.
--nys-color-base
#ededed
Color Base Weak
Base background color for supplementary informational messages.
--nys-color-base-weak
#721c1c
Color Emergency
Emergency color for critical alerts or actions. Use sparingly.
--nys-color-emergency
#d89191
Color Emergency Weak
Emergency background color for critical alerts or actions. Refrain from using for other purposes.
--nys-color-emergency-weak
#1b1b1b
Color Ink
Default for non-text and non-surface elements on a light background.
--nys-color-ink
#ffffff
Color Ink Reverse
Default for non-text and non-surface elements on a dark background.
--nys-color-ink-reverse
#1b1b1b
Color Text
Default text color on surface or surface raised.
--nys-color-text
#4a4d4f
Color Text Weak
Default text color on surface or surface raised.
--nys-color-text-weak
#797c7f
Color Text Weaker
Default text color on surface or surface raised.
--nys-color-text-weaker
#bec0c1
Color Text Weakest
Default text color on surface or surface raised.
--nys-color-text-weakest
#bec0c1
Color Text Disabled
Default text color for disabled state.
--nys-color-text-disabled
#004dd1
Color Link
Standard color for text links.
--nys-color-link
#003ba1
Color Link Strong
Used for hover and active states on text links.
--nys-color-link-strong
#002971
Color Link Strongest
Used for pressed states on text links.
--nys-color-link-strongest
#1b1b1b
Color Link Neutral
Default color for text-based links pressed state.
--nys-color-link-neutral
#004dd1
Color Focus
Used to color focus rings on interactive elements.
--nys-color-focus
#ffffff
Color Text Reverse
Default text color against primary theme color.
--nys-color-text-reverse
#d0d0ce
Color Text Reverse Weak
Default text color against primary theme color.
--nys-color-text-reverse-weak
#bec0c1
Color Text Reverse Weaker
Default text color against primary theme color.
--nys-color-text-reverse-weaker
#62666a
Color Text Reverse Disabled
Default text color against primary theme color.
--nys-color-text-reverse-disabled
#a7a9ab
Color Link Reverse
Default text color against primary theme color.
--nys-color-link-reverse
#ededed
Color Link Reverse Strong
Default text color against primary theme color.
--nys-color-link-reverse-strong
#ffffff
Color Link Reverse Strongest
Default text color against primary theme color.
--nys-color-link-reverse-strongest
#ffffff
Color Link Reverse Neutral
Default text color against primary theme color.
--nys-color-link-reverse-neutral
#1b1b1b
Color Surface Reverse
Provides a strong contrast against {surface}. Used in the UNav footer.
--nys-color-surface-reverse
#ffffff
Color Surface
Default surface. Frame background color, card background, and modal background.
--nys-color-surface
#f6f6f6
Color Surface Raised
Provides a subtle contrast against {surface}. For use in the UNav Header: Trust Bar Dropdown Background, Language Dropdown Background
--nys-color-surface-raised
#1b1b1b
Color Neutral 900
Darkest neutral color.
--nys-color-neutral-900
#323435
Color Neutral 800
Very dark neutral.
--nys-color-neutral-800
#4a4d4f
Color Neutral 700
Dark neutral.
--nys-color-neutral-700
#62666a
Color Neutral 600
Medium-dark neutral.
--nys-color-neutral-600
#797c7f
Color Neutral 500
Mid-range neutral.
--nys-color-neutral-500
#909395
Color Neutral 400
Medium-light neutral.
--nys-color-neutral-400
#a7a9ab
Color Neutral 300
Soft gray neutral.
--nys-color-neutral-300
#bec0c1
Color Neutral 200
Pale gray neutral.
--nys-color-neutral-200
#d0d0ce
Color Neutral 100
Very light gray neutral
--nys-color-neutral-100
#ededed
Color Neutral 50
Soft off-white neutral.
--nys-color-neutral-50
#f6f6f6
Color Neutral 10
Lightest visible neutral.
--nys-color-neutral-10
#ffffff
Color Black Transparent 50
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-50
#000000
Color Black Transparent 100
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-100
hsla(0, 0%, 100%, 0)
Color Black Transparent 200
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-200
#a7a9ab
Color Black Transparent 300
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-300
#909395
Color Black Transparent 400
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-400
#797C7F
Color Black Transparent 500
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-500
#62666a
Color Black Transparent 600
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-600
#4a4d4f
Color Black Transparent 700
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-700
#323435
Color Black Transparent 800
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-800
#1b1b1b
Color Black Transparent 900
A black transparent overlay to be used with light backgrounds.
--nys-color-black-transparent-900
#ffffff
Color White Transparent 50
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-50
#000000
Color White Transparent 100
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-100
hsla(0, 0%, 100%, 0)
Color White Transparent 200
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-200
#a7a9ab
Color White Transparent 300
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-300
#909395
Color White Transparent 400
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-400
#797c7f
Color White Transparent 500
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-500
#62666a
Color White Transparent 600
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-600
#4a4d4f
Color White Transparent 700
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-700
#323435
Color White Transparent 800
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-800
#1b1b1b
Color White Transparent 900
A white transparent overlay to be used with dark backgrounds.
--nys-color-white-transparent-900
Font-family
Font Family, Sans
Primary brand font, used for content, headers, and UI text. → Proxima Nova, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica, Arial, sans-serif, Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol
--nys-font-family-sans
Font Family, Agency
Brand font used only for agency, program, and initiative titles. → D Sari, Arial, sans-serif
--nys-font-family-agency
Font Family, Alternate
Alternate brand font, used sparingly for accent in public-facing sites. → Oswald, Arial, sans-serif
--nys-font-family-alt
Font-size
Font Size, 2XS
Extra-extra-small font size. Typically used for fine print or disclaimers. → 10px
--nys-font-size-2xs
Font Size, XS
Extra-small font size. Used for less prominent labels or captions. → 12px
--nys-font-size-xs
Font Size, SM
Small font size. Commonly used for secondary text or labels. → 14px
--nys-font-size-sm
Font Size, MD
Medium font size. Default body text size. → 16px
--nys-font-size-md
Font Size, LG
Large font size. Used for subheadings or larger labels. → 18px
--nys-font-size-lg
Font Size, XL
Extra-large font size. Used for headings or standout elements. → 20px
--nys-font-size-xl
Font Size, 2XL
Double extra-large font size. Commonly used for secondary headings. → 22px
--nys-font-size-2xl
Font Size, 3XL
Triple extra-large font size. Used for primary headings or key text. → 24px
--nys-font-size-3xl
Font Size, 4XL
Quadruple extra-large font size. Typically used for prominent headlines. → 28px
--nys-font-size-4xl
Font Size, 5XL
Quintuple extra-large font size. Reserved for key marketing or hero sections. → 32px
--nys-font-size-5xl
Font Size, 6XL
Six times extra-large font size. Used for impactful hero text. → 36px
--nys-font-size-6xl
Font Size, 7XL
Seven times extra-large font size. Highly prominent text. → 40px
--nys-font-size-7xl
Font Size, 8XL
Eight times extra-large font size. Typically for titles or splash content. → 44px
--nys-font-size-8xl
Font Size, 9XL
Nine times extra-large font size. Maximum size for hero content. → 50px
--nys-font-size-9xl
Space
Space 1px
Spacing tokens standardize margins, padding, and gaps in layouts. This is ultra-thin for fine detail, like borders or dividers.
--nys-space-1px
Space 2px
Very small spacing for micro-adjustments or compact layouts.
--nys-space-2px
Space 50
Extra-small spacing, typically used for tight content spacing.
--nys-space-50
Space 100
Small spacing, often used for compact layouts or minimal margins.
--nys-space-100
Space 150
Small-medium spacing for general UI elements.
--nys-space-150
Space 200
Medium spacing, commonly used for standard element separation.
--nys-space-200
Space 250
Medium-large spacing for container padding or visual balance.
--nys-space-250
Space 300
Standard spacing for layouts with moderate separation.
--nys-space-300
Space 400
Large spacing for separating sections or creating visual breaks.
--nys-space-400
Space 500
Extra-large spacing for major sections or wide gaps.
--nys-space-500
Space 600
Very large spacing, often used for section padding or layouts.
--nys-space-600
Space 700
Generous spacing for wide content separation.
--nys-space-700
Space 800
Maximum spacing for highly open designs or major layouts.
--nys-space-800
Space 1200
Largest spacing token for creating significant visual separation.
--nys-space-1200
Size
Size 1px
Size tokens standardize the width and height of elements, like icons, typography, and UI components.
--nys-size-1px
Size 2px
Slightly thicker size for minimal elements, such as borders.
--nys-size-2px
Size 50
Extra-small size for compact UI elements or icons.
--nys-size-50
Size 100
Small size for UI elements or containers.
--nys-size-100
Size 150
Small-medium size for buttons or small containers.
--nys-size-150
Size 200
Medium size, often used for inputs or cards.
--nys-size-200
Size 250
Medium-large size for slightly larger UI elements.
--nys-size-250
Size 300
Standard size for larger UI controls or containers.
--nys-size-300
Size 400
Large size for buttons, modals, or prominent elements.
--nys-size-400
Size 500
Very large size for main containers or sections.
--nys-size-500
Size 600
Extra-large size for significant UI containers or elements.
--nys-size-600
Size 700
Massive size for prominent layout features.
--nys-size-700
Size 800
Largest size for visual anchors or major elements.
--nys-size-800
Size 1200
Maximum size for expansive layouts or hero elements.
--nys-size-1200
Radius
Radius XS
Extra-small radius for subtle rounding.
--nys-radius-xs
Radius SM
Small radius for slightly rounded elements.
--nys-radius-sm
Radius MD
Medium radius input elements like text fields, checkboxes, and select dropdowns.
--nys-radius-md
Radius LG
Larger radius for a more pronounced rounding.
--nys-radius-lg
Radius XL
Extra-large radius for buttons, to quickly indicate interactivity.
--nys-radius-xl
Radius Round
Fully rounded elements. Used for avatars and icons.
--nys-radius-round