ThisCalculator

Everyday

Mac Button Design Shift: Bold to Modern Controls

Updated · Standard formula, shown below

This guide explains how macOS button design evolved from the bold, glossy, and heavily bordered controls of the past to the modern, flat, and functional style seen in current versions. You’ll learn the key visual changes, the reasoning behind them, and how to apply the modern approach to your own app designs or UI mockups. No special tools are needed—just an understanding of basic design principles and access to a design program like Sketch, Figma, or even a simple image editor.

What You’ll Need

  • A design tool (Figma, Sketch, Adobe XD, or similar)
  • Basic familiarity with layers, fills, strokes, and effects
  • A reference image of a current macOS button (optional but helpful)

Step-by-Step

  1. Understand the old style. Classic macOS buttons (pre-Yosemite) featured heavy gradients, glossy highlights, thick borders, and often a drop shadow that made them look raised and tactile. They were designed to mimic physical buttons.
  2. Adopt the flat aesthetic. Modern macOS buttons are flat. Remove gradients, bevels, and glossy highlights. Use a single solid fill color for the button background.
  3. Simplify the border. Replace thick, dark borders with a subtle 1-pixel stroke that matches the button’s fill color, or use no border at all. For outlined buttons, use a thin, light gray stroke.
  4. Choose a neutral background. Standard buttons now use a light gray fill (around #F0F0F0) that blends with the window background. Accent buttons (like the default action) use a blue fill (around #007AFF).
  5. Update typography. Use the system font (San Francisco) at a readable size (13-14 pt). Text should be dark gray (#333333) on light buttons and white on blue buttons. Avoid bold weights unless the button is the primary action.
  6. Soften the shadow. A subtle drop shadow is still acceptable, but it should be very light, with low opacity (10-20%), and positioned directly below the button to suggest a slight elevation, not a deep 3D effect.
  7. Add rounded corners. Modern buttons have rounded corners with a corner radius of about 6-8 pixels. This matches the system’s overall rounded aesthetic.
  8. Handle states. Design hover, pressed, and disabled states. On hover, darken the fill slightly. On press, invert the background and text colors (or move the text down 1 pixel). Disabled buttons should have a gray fill with reduced text opacity.
  9. Use system components. In your actual app, use the standard NSButton class with the appropriate bezel style (like `rounded` or `texturedRounded`). This ensures your button automatically matches the current OS look and behavior.
  10. Test in context. Place your button in a realistic window mockup to see how it interacts with other UI elements. Adjust spacing and alignment to match Apple’s Human Interface Guidelines.

Common Mistakes

  • Keeping the old glossy highlight: This is the most obvious giveaway of an outdated design. Remove it entirely.
  • Using overly dark borders: Modern buttons have very subtle or no borders. A thick dark stroke makes the button look heavy.
  • Making the shadow too strong: A harsh drop shadow defeats the purpose of the flat design. Keep it minimal.
  • Ignoring the pressed state: A button that doesn’t visually respond when clicked feels broken. Always design a distinct pressed state.
  • Mixing styles: Don’t combine a flat fill with a 3D bevel. Consistency is key.

Tips

  • Use the built-in system buttons whenever possible. They automatically adapt to the user’s system theme (light/dark) and accessibility settings.
  • If you’re designing in Figma or Sketch, create a reusable component for your buttons to ensure consistency across your design.
  • Pay attention to the button’s height. Apple recommends a minimum of 28 points for a standard button.
  • Use the accent color for the primary action button in a window or dialog. This helps users quickly identify the most important action.
  • For icon buttons, use SF Symbols and ensure they are scaled appropriately. The icon should be centered and the button size should be at least 28×28 points.

Troubleshooting

  • Your button still looks old: Double-check that you’ve removed all gradients, bevels, and glossy effects. Look at a real macOS button side-by-side and compare every property.
  • The button doesn’t look native: If you’re using a custom-drawn button, consider switching to the standard NSButton class. It handles all the visual details automatically.
  • The pressed state isn’t working: In code, make sure you’re using `setButtonType(.momentaryPushIn)` for a standard push button. For custom drawing, ensure you’re redrawing on mouse down.
  • The button looks too flat and blends in: Add a very subtle 1-pixel border with a slightly darker gray (e.g., #D0D0D0) to give it definition without going back to the old style.
  • Dark mode is broken: If you’re using hardcoded colors, they won’t adapt. Use system colors like `NSColor.controlColor` and `NSColor.controlTextColor` instead.

Frequently Asked Questions

  1. Why did Apple change the button design? The shift to flat design was part of a broader trend toward simplicity and reduced visual clutter. It also made the interface feel more modern and focused on content, rather than the UI chrome.
  2. Can I still use the old style in my app? Yes, but it will look outdated and out of place on modern macOS. Users may perceive it as unmaintained. It’s best to follow the current design language.
  3. What is the exact hex code for the blue accent button? The standard accent blue is #007AFF, but it can vary slightly with system settings. Use the system’s `controlAccentColor` to get the correct one.
  4. Do I need to design for both light and dark mode? Yes, your buttons should look good in both. Using system colors and materials will automatically handle this.
  5. How do I make a button look disabled? Reduce the opacity of the text and fill, or use a gray fill with lighter text. The system automatically does this for standard buttons when you set `isEnabled = false`.
  6. What’s the difference between a push button and a momentary light button? A push button (momentaryPushIn) is the standard button that triggers an action. A momentary light button is used for toggles and shows a state change. For most actions, use the push button.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.