Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

macOS button text differs from SwiftUI in interaction snapshots

Open Beginner friendly
  • Is something wrong?
#1,140 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@Kyle-Ye is already working on this.

Since Oct 12, 2026.

  • #1141 by @Kyle-Ye — open

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
74/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
macos, swift
Domain
frontend, testing

Research direction

Start with renderKeyedText, identified in the issue as using white to draw the alpha-only text mask; compare how it uses the resolved foreground color. Then run ButtonInteractionTests with reference updates disabled and inspect the enabled and disabled snapshot cases. Done means all six captures match the SwiftUI references.

Written by the indexing model from the issue text.

Description

area: rendering area: text impact: visual-diff platform: macOS type: bug

Description

Default button labels rendered by OpenSwiftUI differ from SwiftUI at the glyph
edges on macOS. Both enabled and disabled buttons are affected. The differences
remain when the reference and actual images use the same macOS version.

Button actions work: repeated presses update the count, and disabled buttons do
not run their actions. The failures are snapshot mismatches, with no crash.

Reproduction

  • Platform: macOS 15.7.3 (24G419), arm64.
  • Configuration: OpenSwiftUI renderer with IAG.
  • References: SwiftUI snapshots recorded on macOS 15.7.3.
  • Source: The Button implementation merged in #1138.

Run the existing
ButtonInteractionTests
with reference updates disabled. The two cases capture the initial appearance
and the appearance after each of two presses:

  1. actionUpdatesCount: The enabled button displays counts 0, 1, and 2.
  2. disabledButtonDoesNotRunAction: The disabled button keeps count 0.

Expected and actual results

All six captures should match the SwiftUI references. Instead, each capture has
differences confined to the text. The button backgrounds and borders match.

Case Initial After first press After second press
Enabled 604 543 556
Disabled 583 583 583

Values are the number of changed RGBA pixels in each reference/actual pair from
the focused CI run.

The reference, actual, and difference images are available in the snapshot
artifact of the CI run linked above.

Enabled and disabled button snapshots, with enlarged text differences

Findings

A local comparison on macOS 15.7.3 reproduced the CI images. View and layer
geometry, glyph positions, fonts, transforms, and text color matched between the
two renderers.

The difference comes from the fill color used to draw the alpha-only text mask
in renderKeyedText. OpenSwiftUI uses white. On macOS, font smoothing depends on
the fill color even in an alpha-only context, so this changes glyph coverage.
Using the resolved foreground RGB for a solid fill removes the differences in
these button snapshots.

A standalone text probe confirmed that black and white fills produce different
alpha masks on macOS 15.7.3 with font smoothing enabled. The masks match with
smoothing disabled. The same probe on iOS 18.5 produced identical masks for both
colors.

Dominant language
Swift
Stars
2.5k
Forks
84
Avg merge
2h 8m
Merged PRs (30d)
62

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from OpenSwiftUIProject/OpenSwiftUI

All issues in OpenSwiftUIProject/OpenSwiftUI

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.