{"abstract":[{"text":"Dark Mode is a systemwide appearance setting that uses a dark color palette to provide a comfortable viewing experience tailored for low-light environments.","type":"text"}],"hierarchy":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.HIG\/design\/human-interface-guidelines","doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/foundations"]]},"identifier":{"interfaceLanguage":"swift","url":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/dark-mode"},"kind":"article","legalNotices":{"copyright":"Copyright &copy; 2026 Apple Inc. All rights reserved.","privacyPolicy":"https:\/\/www.apple.com\/privacy\/privacy-policy","termsOfUse":"https:\/\/www.apple.com\/legal\/internet-services\/terms\/site.html"},"metadata":{"availableLanguages":["en-US","zh-CN","ja-JP","ko-KR"],"customMetadata":{"alert-date":"2024-08-06","alert-text":"Added art contrasting the light and dark appearances.","supported-platforms":"ios,ipados,macos,tvos"},"images":[{"identifier":"dark-mode.svg","type":"icon"},{"identifier":"foundations-dark-mode-thumbnail.png","type":"card"}],"role":"article","title":"Dark Mode"},"primaryContentSections":[{"content":[{"inlineContent":[{"identifier":"foundations-dark-mode-intro.png","type":"image"}],"type":"paragraph"},{"inlineContent":[{"text":"In iOS, iPadOS, macOS, and tvOS, people often choose Dark Mode as their default interface style, and they generally expect all apps and games to respect their preference. In Dark Mode, the system uses a dark color palette for all screens, views, menus, and controls, and may also use greater perceptual contrast to make foreground content stand out against the darker backgrounds.","type":"text"}],"type":"paragraph"},{"anchor":"Best-practices","level":2,"text":"Best practices","type":"heading"},{"inlineContent":[{"inlineContent":[{"text":"Avoid offering an app-specific appearance setting.","type":"text"}],"type":"strong"},{"text":" An app-specific appearance mode option creates more work for people because they have to adjust more than one setting to get the appearance they want. Worse, they may think your app is broken because it doesn’t respond to their systemwide appearance choice.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Ensure that your app looks good in both appearance modes.","type":"text"}],"type":"strong"},{"text":" In addition to using one mode or the other, people can choose the Auto appearance setting, which switches between the light and dark appearances as conditions change throughout the day, potentially while your app is running.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Test your content to make sure that it remains comfortably legible in both appearance modes.","type":"text"}],"type":"strong"},{"text":" For example, in Dark Mode with Increase Contrast and Reduce Transparency turned on (both separately and together), you may find places where dark text is less legible when it’s on a dark background. You might also find that turning on Increase Contrast in Dark Mode can result in reduced visual contrast between dark text and a dark background. Although people with strong vision might still be able to read lower contrast text, such text could be illegible for many. For guidance, see ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/accessibility","isActive":true,"type":"reference"},{"text":".","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"In rare cases, consider using only a dark appearance in the interface.","type":"text"}],"type":"strong"},{"text":" For example, it can make sense for an app that supports immersive media viewing to use a permanently dark appearance that lets the UI recede and helps people focus on the media.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"identifier":"dark-mode-stocks-app-dark-only-mode.png","metadata":{"abstract":[{"text":"The Stocks app uses a dark-only appearance","type":"text"}],"deviceFrame":"iPhone16"},"type":"image"}],"type":"paragraph"},{"anchor":"Dark-Mode-colors","level":2,"text":"Dark Mode colors","type":"heading"},{"inlineContent":[{"text":"The color palette in Dark Mode includes dimmer background colors and brighter foreground colors. It’s important to realize that these colors aren’t necessarily inversions of their light counterparts: while many colors are inverted, some are not. For more information, see ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/color#Specifications","isActive":true,"type":"reference"},{"text":".","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Embrace colors that adapt to the current appearance.","type":"text"}],"type":"strong"},{"text":" Semantic colors (like ","type":"text"},{"identifier":"doc:\/\/com.apple.documentation\/documentation\/AppKit\/NSColor\/labelColor","isActive":true,"type":"reference"},{"text":" and ","type":"text"},{"identifier":"doc:\/\/com.apple.documentation\/documentation\/AppKit\/NSColor\/controlColor","isActive":true,"type":"reference"},{"text":" in macOS or ","type":"text"},{"identifier":"doc:\/\/com.apple.documentation\/documentation\/UIKit\/UIColor\/separator","isActive":true,"type":"reference"},{"text":" in iOS and iPadOS) automatically adapt to the current appearance. When you need a custom color, add a Color Set asset to your app’s asset catalog in Xcode, and specify the bright and dim variants of the color. Avoid using hard-coded color values or colors that don’t adapt.","type":"text"}],"type":"paragraph"},{"columns":[{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-system-colors-light.png","metadata":{"abstract":[{"text":"System colors in the light appearance","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1},{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-system-colors-dark.png","metadata":{"abstract":[{"text":"System colors in the dark appearance","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1}],"numberOfColumns":2,"type":"row"},{"inlineContent":[{"inlineContent":[{"text":"Aim for sufficient color contrast in all appearances.","type":"text"}],"type":"strong"},{"text":" Using system-defined colors can help you achieve a good contrast ratio between your foreground and background content. At a minimum, make sure the contrast ratio between colors is no lower than 4.5:1. For custom foreground and background colors, strive for a contrast ratio of 7:1, especially in small text. This ratio ensures that your foreground content stands out from the background, and helps your content meet recommended accessibility guidelines.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Soften the color of white backgrounds.","type":"text"}],"type":"strong"},{"text":" If you display a content image that includes a white background, consider slightly darkening the image to prevent the background from glowing in the surrounding Dark Mode context.","type":"text"}],"type":"paragraph"},{"anchor":"Icons-and-images","level":3,"text":"Icons and images","type":"heading"},{"inlineContent":[{"text":"The system uses ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/sf-symbols","isActive":true,"type":"reference"},{"text":" (which automatically adapt to Dark Mode) and full-color images that are optimized for both the light and dark appearances.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Use SF Symbols wherever possible.","type":"text"}],"type":"strong"},{"text":" Symbols work well in both appearance modes when you use dynamic colors to tint them or when you add vibrancy. For guidance, see ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/color","isActive":true,"type":"reference"},{"text":".","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Design separate interface icons for the light and dark appearances if necessary.","type":"text"}],"type":"strong"},{"text":" For example, an icon that depicts a full moon might need a subtle dark outline to contrast well with a light background, but need no outline when it displays on a dark background. Similarly, an icon that represents a drop of oil might need a slight border to make the edge visible against a dark background.","type":"text"}],"type":"paragraph"},{"columns":[{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-icon-in-light-mode.png","metadata":{"abstract":[{"text":"Icon in the light appearance with no border","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1},{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-icon-in-dark-mode.png","metadata":{"abstract":[{"text":"Icon in the dark appearance with border for better contrast","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1}],"numberOfColumns":2,"type":"row"},{"inlineContent":[{"inlineContent":[{"text":"Make sure full-color images and icons look good in both appearances.","type":"text"}],"type":"strong"},{"text":" Use the same asset if it looks good in both the light and dark appearances. If an asset looks good in only one mode, modify the asset or create separate light and dark assets. Use asset catalogs to combine your assets into a single named image.","type":"text"}],"type":"paragraph"},{"columns":[{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-illustration-in-light-mode.png","metadata":{"abstract":[{"text":"Illustration on a light background","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1},{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-illustration-in-dark-mode-incorrect.png","metadata":{"abstract":[{"text":"On a dark background, the same illustration has poor contrast and many details are lost","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1},{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-illustration-in-dark-mode-correct.png","metadata":{"abstract":[{"text":"Illustration adjusted for better contrast on a dark background","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1}],"numberOfColumns":3,"type":"row"},{"anchor":"Text","level":3,"text":"Text","type":"heading"},{"inlineContent":[{"text":"The system uses vibrancy and increased contrast to maintain the legibility of text on darker backgrounds.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Use the system-provided label colors for labels.","type":"text"}],"type":"strong"},{"text":" The primary, secondary, tertiary, and quaternary label colors adapt automatically to the light and dark appearances.","type":"text"}],"type":"paragraph"},{"columns":[{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-label-in-light-mode.png","metadata":{"abstract":[{"text":"Primary label in the light appearance","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1},{"alignment":"leading","content":[{"inlineContent":[{"identifier":"dark-mode-label-in-dark-mode.png","metadata":{"abstract":[{"text":"Secondary label in the dark appearance","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1}],"numberOfColumns":2,"type":"row"},{"inlineContent":[{"inlineContent":[{"text":"Use system views to draw text fields and text views.","type":"text"}],"type":"strong"},{"text":" System views and controls make your app’s text look good on all backgrounds, adjusting automatically for the presence or absence of vibrancy. When possible, use a system-provided view to display text instead of drawing the text yourself.","type":"text"}],"type":"paragraph"},{"anchor":"Platform-considerations","level":2,"text":"Platform considerations","type":"heading"},{"inlineContent":[{"inlineContent":[{"text":"No additional considerations for tvOS. Dark Mode isn’t supported in visionOS or watchOS.","type":"text"}],"type":"emphasis"}],"type":"paragraph"},{"anchor":"iOS-iPadOS","level":3,"text":"iOS, iPadOS","type":"heading"},{"inlineContent":[{"text":"In Dark Mode, the system uses two sets of background colors — called ","type":"text"},{"inlineContent":[{"text":"base","type":"text"}],"type":"emphasis"},{"text":" and ","type":"text"},{"inlineContent":[{"text":"elevated","type":"text"}],"type":"emphasis"},{"text":" — to enhance the perception of depth when one dark interface is layered above another. The base colors are dimmer, making background interfaces appear to recede, and the elevated colors are brighter, making foreground interfaces appear to advance.","type":"text"}],"type":"paragraph"},{"columns":[{"alignment":"leading","content":[{"inlineContent":[{"identifier":"base-with-four-semantic-colors.png","metadata":{"abstract":[{"text":"Base","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1},{"alignment":"leading","content":[{"inlineContent":[{"identifier":"elevated-with-four-semantic-colors.png","metadata":{"abstract":[{"text":"Elevated","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1},{"alignment":"leading","content":[{"inlineContent":[{"identifier":"light-with-four-semantic-colors.png","metadata":{"abstract":[{"text":"Light","type":"text"}]},"type":"image"}],"type":"paragraph"}],"size":1}],"numberOfColumns":3,"type":"row"},{"inlineContent":[{"inlineContent":[{"text":"Prefer the system background colors.","type":"text"}],"type":"strong"},{"text":" Dark Mode is dynamic, which means that the background color automatically changes from base to elevated when an interface is in the foreground, such as a popover or modal sheet. The system also uses the elevated background color to provide visual separation between apps in a multitasking environment and between windows in a multiple-window context. Using a custom background color can make it harder for people to perceive these system-provided visual distinctions.","type":"text"}],"type":"paragraph"},{"anchor":"macOS","level":3,"text":"macOS","type":"heading"},{"inlineContent":[{"text":"When people choose the graphite accent color in General settings, macOS causes window backgrounds to pick up color from the current desktop picture. The result — called ","type":"text"},{"inlineContent":[{"text":"desktop tinting","type":"text"}],"type":"emphasis"},{"text":" — is a subtle effect that helps windows blend more harmoniously with their surrounding content.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Include some transparency in custom component backgrounds when appropriate.","type":"text"}],"type":"strong"},{"text":" Transparency lets your components pick up color from the window background when desktop tinting is active, creating a visual harmony that can persist even when the desktop picture changes. To help achieve this harmony, add transparency only to a custom component that has a visible background or bezel, and only when the component is in a neutral state, such as state that doesn’t use color. You don’t want to add transparency when the component is in a state that uses color, because doing so can cause the component’s color to fluctuate when the window background adjusts to a different location on the desktop or when the desktop picture changes.","type":"text"}],"type":"paragraph"},{"anchor":"Resources","level":2,"text":"Resources","type":"heading"},{"anchor":"Related","level":4,"text":"Related","type":"heading"},{"inlineContent":[{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/color","isActive":true,"type":"reference"}],"type":"paragraph"},{"inlineContent":[{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/materials","isActive":true,"type":"reference"}],"type":"paragraph"},{"inlineContent":[{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/typography","isActive":true,"type":"reference"}],"type":"paragraph"},{"anchor":"Videos","level":4,"text":"Videos","type":"heading"},{"items":["doc:\/\/com.apple.documentation\/videos\/play\/wwdc2025\/219","doc:\/\/com.apple.documentation\/videos\/play\/wwdc2019\/214"],"style":"compactGrid","type":"links"},{"anchor":"Change-log","level":2,"text":"Change log","type":"heading"},{"header":"row","rows":[[[{"inlineContent":[{"text":"Date","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Changes","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"August 6, 2024","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Added art contrasting the light and dark appearances.","type":"text"}],"type":"paragraph"}]]],"type":"table"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"topicSectionsStyle":"compactGrid","references":{"174747D6-8723-4194-A932-7765179F1108":{"alt":null,"identifier":"174747D6-8723-4194-A932-7765179F1108","type":"image","variants":[{"traits":["1x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/48\/174747D6-8723-4194-A932-7765179F1108\/2949_wide_250x141_1x.jpg"},{"traits":["2x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/48\/174747D6-8723-4194-A932-7765179F1108\/2949_wide_250x141_2x.jpg"},{"traits":["3x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/48\/174747D6-8723-4194-A932-7765179F1108\/2949_wide_250x141_3x.jpg"}]},"5CD0E251-424E-490F-89CF-1E64848209A6":{"alt":null,"identifier":"5CD0E251-424E-490F-89CF-1E64848209A6","type":"image","variants":[{"traits":["1x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/3055294D-836B-4513-B7B0-0BC5666246B0\/5CD0E251-424E-490F-89CF-1E64848209A6\/9910_wide_250x141_1x.jpg"},{"traits":["2x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/3055294D-836B-4513-B7B0-0BC5666246B0\/5CD0E251-424E-490F-89CF-1E64848209A6\/9910_wide_250x141_2x.jpg"},{"traits":["3x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/3055294D-836B-4513-B7B0-0BC5666246B0\/5CD0E251-424E-490F-89CF-1E64848209A6\/9910_wide_250x141_3x.jpg"}]},"accessibility.svg":{"alt":"The Accessibility icon.","identifier":"accessibility.svg","type":"image","variants":[{"svgID":"accessibility","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/accessibility.svg"}]},"base-with-four-semantic-colors.png":{"alt":"A diagram that shows a stack of 4 terms on top of a black background. The term at the top shows the most contrast with the background and the term at the bottom shows the least.","identifier":"base-with-four-semantic-colors.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/base-with-four-semantic-colors@2x.png"}]},"color.svg":{"alt":"An icon of a paint palette that suggests the use of color.","identifier":"color.svg","type":"image","variants":[{"svgID":"color","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/color.svg"}]},"dark-mode-icon-in-dark-mode.png":{"alt":"An illustration of a black droplet icon against a dark background. The icon has a white border to distinguish it from the similar surrounding color.","identifier":"dark-mode-icon-in-dark-mode.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-icon-in-dark-mode@2x.png"}]},"dark-mode-icon-in-light-mode.png":{"alt":"An illustration of a black droplet icon against a light background.","identifier":"dark-mode-icon-in-light-mode.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-icon-in-light-mode@2x.png"}]},"dark-mode-illustration-in-dark-mode-correct.png":{"alt":"An illustration of two people sitting at a restaurant table done in a simple, abstract style. The illustration has a dark background, and its color values are adjusted to be clearly visible in contrast to the background.","identifier":"dark-mode-illustration-in-dark-mode-correct.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-illustration-in-dark-mode-correct@2x.png"}]},"dark-mode-illustration-in-dark-mode-incorrect.png":{"alt":"An illustration of two people sitting at a restaurant table done in a simple, abstract style. The illustration has a dark background, and the darker portions of the image are hard to distinguish from the background.","identifier":"dark-mode-illustration-in-dark-mode-incorrect.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-illustration-in-dark-mode-incorrect@2x.png"}]},"dark-mode-illustration-in-light-mode.png":{"alt":"An illustration of two people sitting at a restaurant table done in a simple, abstract style. The illustration has a light background and its details are clearly visible.","identifier":"dark-mode-illustration-in-light-mode.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-illustration-in-light-mode@2x.png"}]},"dark-mode-label-in-dark-mode.png":{"alt":"An illustration of a button in the dark appearance with light secondary label text.","identifier":"dark-mode-label-in-dark-mode.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-label-in-dark-mode@2x.png"}]},"dark-mode-label-in-light-mode.png":{"alt":"An illustration of a button in the light appearance with dark primary label text.","identifier":"dark-mode-label-in-light-mode.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-label-in-light-mode@2x.png"}]},"dark-mode-stocks-app-dark-only-mode.png":{"alt":"A screenshot of the Stocks app on iPhone in its standard dark-only appearance, showing the Apple Inc. stock in detail. The view includes a summary of the current stock price along with a graph of its performance over the past year.","identifier":"dark-mode-stocks-app-dark-only-mode.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-stocks-app-dark-only-mode@2x.png"}]},"dark-mode-system-colors-dark.png":{"alt":"An illustration of a square with a dark background and four color swatches representing system colors in the dark appearance.","identifier":"dark-mode-system-colors-dark.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-system-colors-dark@2x.png"}]},"dark-mode-system-colors-light.png":{"alt":"An illustration of a square with a light background and four color swatches representing system colors in the light appearance.","identifier":"dark-mode-system-colors-light.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/dark-mode-system-colors-light@2x.png"}]},"dark-mode.svg":{"alt":"An icon of concentric circles with half-filled areas that suggests the presence of light and dark.","identifier":"dark-mode.svg","type":"image","variants":[{"svgID":"dark-mode","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/dark-mode.svg"}]},"doc://com.apple.HIG/design/Human-Interface-Guidelines/accessibility":{"abstract":[{"text":"Accessible user interfaces empower everyone to have a great experience with your app or game.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/accessibility","images":[{"identifier":"accessibility.svg","type":"icon"},{"identifier":"foundations-accessibility-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Accessibility","type":"topic","url":"\/design\/human-interface-guidelines\/accessibility"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/color":{"abstract":[{"text":"Judicious use of color can enhance communication, evoke your brand, provide visual continuity, communicate status and feedback, and help people understand information.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/color","images":[{"identifier":"color.svg","type":"icon"},{"identifier":"foundations-color-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Color","type":"topic","url":"\/design\/human-interface-guidelines\/color"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/color#Specifications":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/color#Specifications","kind":"section","title":"Specifications","type":"topic","url":"\/design\/human-interface-guidelines\/color#Specifications"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/foundations":{"abstract":[{"text":"Understand how fundamental design elements help you create rich experiences.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/foundations","images":[{"identifier":"overview.svg","type":"icon"},{"identifier":"foundations.png","type":"card"}],"kind":"article","role":"collectionGroup","title":"Foundations","type":"topic","url":"\/design\/human-interface-guidelines\/foundations"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/materials":{"abstract":[{"text":"A material is a visual effect that creates a sense of depth, layering, and hierarchy between foreground and background elements.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/materials","images":[{"identifier":"materials.svg","type":"icon"},{"identifier":"foundations-materials-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Materials","type":"topic","url":"\/design\/human-interface-guidelines\/materials"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/sf-symbols":{"abstract":[{"text":"SF Symbols provides thousands of consistent, highly configurable symbols that integrate seamlessly with the San Francisco system font, automatically aligning with text in all weights and sizes.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/sf-symbols","images":[{"identifier":"sf-symbols.svg","type":"icon"},{"identifier":"foundations-sf-symbols-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"SF Symbols","type":"topic","url":"\/design\/human-interface-guidelines\/sf-symbols"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/typography":{"abstract":[{"text":"Your typographic choices can help you display legible text, convey an information hierarchy, communicate important content, and express your brand or style.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/typography","images":[{"identifier":"typography.svg","type":"icon"},{"identifier":"foundations-typography-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Typography","type":"topic","url":"\/design\/human-interface-guidelines\/typography"},"doc://com.apple.HIG/design/human-interface-guidelines":{"abstract":[{"text":"The HIG contains guidance and best practices that can help you design a","type":"text"},{"text":" ","type":"text"},{"text":"great experience for any Apple platform.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/human-interface-guidelines","images":[{"identifier":"human-interface-guidelines-page-image-card.png","type":"card"}],"kind":"article","role":"collection","title":"Human Interface Guidelines","type":"topic","url":"\/design\/human-interface-guidelines"},"doc://com.apple.documentation/documentation/AppKit/NSColor/controlColor":{"abstract":[{"text":"The color to use for the flat surfaces of a control.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"controlColor"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)NSColor","text":"NSColor"}],"identifier":"doc:\/\/com.apple.documentation\/documentation\/AppKit\/NSColor\/controlColor","kind":"symbol","role":"symbol","title":"controlColor","type":"topic","url":"\/documentation\/appkit\/nscolor\/controlcolor"},"doc://com.apple.documentation/documentation/AppKit/NSColor/labelColor":{"abstract":[{"text":"The primary color to use for text labels.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"labelColor"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)NSColor","text":"NSColor"}],"identifier":"doc:\/\/com.apple.documentation\/documentation\/AppKit\/NSColor\/labelColor","kind":"symbol","role":"symbol","title":"labelColor","type":"topic","url":"\/documentation\/appkit\/nscolor\/labelcolor"},"doc://com.apple.documentation/documentation/UIKit/UIColor/separator":{"abstract":[{"text":"The color for thin borders or divider lines that allows some underlying content to be visible.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"separator"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)UIColor","text":"UIColor"}],"identifier":"doc:\/\/com.apple.documentation\/documentation\/UIKit\/UIColor\/separator","kind":"symbol","role":"symbol","title":"separator","type":"topic","url":"\/documentation\/uikit\/uicolor\/separator"},"doc://com.apple.documentation/documentation/technologies":{"abstract":[],"identifier":"doc:\/\/com.apple.documentation\/documentation\/technologies","kind":"technologies","role":"overview","title":"Technologies","type":"topic","url":"\/documentation\/technologies"},"doc://com.apple.documentation/videos/play/wwdc2019/214":{"abstract":[{"text":"Hear from the UIKit engineering team about the principles and concepts that anchor Dark Mode on iOS. Get introduced to the principles of enhancing your app with this new appearance using dynamic colors and images, and add an experience that people are sure to love.","type":"text"}],"identifier":"doc:\/\/com.apple.documentation\/videos\/play\/wwdc2019\/214","images":[{"identifier":"174747D6-8723-4194-A932-7765179F1108","type":"card"}],"kind":"article","role":"article","title":"Implementing Dark Mode on iOS","type":"topic","url":"https:\/\/developer.apple.com\/videos\/play\/wwdc2019\/214"},"doc://com.apple.documentation/videos/play/wwdc2025/219":{"abstract":[{"text":"Liquid Glass unifies Apple platform design language while providing a more dynamic and expressive user experience. Get to know the design principles of Liquid Glass, explore its core optical and physical properties, and learn where to use it and why.","type":"text"}],"identifier":"doc:\/\/com.apple.documentation\/videos\/play\/wwdc2025\/219","images":[{"identifier":"5CD0E251-424E-490F-89CF-1E64848209A6","type":"card"}],"kind":"article","role":"article","title":"Meet Liquid Glass","type":"topic","url":"https:\/\/developer.apple.com\/videos\/play\/wwdc2025\/219"},"elevated-with-four-semantic-colors.png":{"alt":"A diagram that shows a stack of 4 terms on top of a nearly black background. The term at the top shows the most contrast with the background and the term at the bottom shows the least.","identifier":"elevated-with-four-semantic-colors.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/elevated-with-four-semantic-colors@2x.png"}]},"foundations-accessibility-thumbnail.png":{"alt":"A sketch of the Accessibility icon. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-accessibility-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-accessibility-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-accessibility-thumbnail~dark@2x.png"}]},"foundations-color-thumbnail.png":{"alt":"A sketch of a paint palette, suggesting the use of color. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-color-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-color-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-color-thumbnail~dark@2x.png"}]},"foundations-dark-mode-intro.png":{"alt":"A sketch of concentric circles with half-filled areas, suggesting the presence of light and dark. The image is overlaid with rectangular and circular grid lines and is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-dark-mode-intro.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-dark-mode-intro@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-dark-mode-intro~dark@2x.png"}]},"foundations-dark-mode-thumbnail.png":{"alt":"A sketch of concentric circles with half-filled areas, suggesting the presence of light and dark. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-dark-mode-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-dark-mode-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-dark-mode-thumbnail~dark@2x.png"}]},"foundations-materials-thumbnail.png":{"alt":"A sketch of a capsule shape overlapping a square. A subtle bend in the edges of the square that are beneath the capsule suggests the layering of the Liquid Glass material over background content. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-materials-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-materials-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-materials-thumbnail~dark@2x.png"}]},"foundations-sf-symbols-thumbnail.png":{"alt":"A sketch of the SF Symbols icon. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-sf-symbols-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-sf-symbols-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-sf-symbols-thumbnail~dark@2x.png"}]},"foundations-typography-thumbnail.png":{"alt":"A sketch of a small letter A to the left of a large letter A, suggesting the use of typography to convey hierarchical information. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-typography-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-typography-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-typography-thumbnail~dark@2x.png"}]},"foundations.png":{"alt":"","identifier":"foundations.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations~dark@2x.png"}]},"human-interface-guidelines-page-image-card.png":{"alt":"An illustration of several Liquid Glass components such as toggles, sliders, and buttons, atop a neutral background. The transparent components cast shadows on the background and allow their colored elements, like a blue slider track and a green toggle backing, to show through, highlighting the Liquid Glass material's lensing effect.","identifier":"human-interface-guidelines-page-image-card.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/human-interface-guidelines-page-image-card@2x.png"}]},"light-with-four-semantic-colors.png":{"alt":"A diagram that shows a stack of 4 terms on top of a white background. The term at the top shows the most contrast with the background and the term at the bottom shows the least.","identifier":"light-with-four-semantic-colors.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/light-with-four-semantic-colors@2x.png"}]},"materials.svg":{"alt":"An icon of overlapping squares that suggests the use of transparency to hint at background content.","identifier":"materials.svg","type":"image","variants":[{"svgID":"materials","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/materials.svg"}]},"overview.svg":{"alt":"An icon of a grid comprised of four squares.","identifier":"overview.svg","type":"image","variants":[{"svgID":"overview","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/overview.svg"}]},"sf-symbols.svg":{"alt":"The SF Symbols icon.","identifier":"sf-symbols.svg","type":"image","variants":[{"svgID":"sf-symbols","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/sf-symbols.svg"}]},"typography.svg":{"alt":"An icon of a small letter A to the left of a large letter A that suggests the use of typography to convey hierarchical information.","identifier":"typography.svg","type":"image","variants":[{"svgID":"typography","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/typography.svg"}]}},"variantOverrides":[{"patch":[{"op":"replace","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1AppKit~1NSColor~1controlColor\/fragments","value":[{"kind":"identifier","text":"controlColor"}]},{"op":"add","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1AppKit~1NSColor~1controlColor\/navigatorTitle","value":[{"kind":"identifier","text":"controlColor"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1AppKit~1NSColor~1labelColor\/fragments","value":[{"kind":"identifier","text":"labelColor"}]},{"op":"add","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1AppKit~1NSColor~1labelColor\/navigatorTitle","value":[{"kind":"identifier","text":"labelColor"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1UIKit~1UIColor~1separator\/title","value":"separatorColor"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1UIKit~1UIColor~1separator\/fragments","value":[{"kind":"identifier","text":"separatorColor"}]},{"op":"add","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1UIKit~1UIColor~1separator\/navigatorTitle","value":[{"kind":"identifier","text":"separatorColor"}]}],"traits":[{"interfaceLanguage":"occ"}]}]}