IosSfSymbolsWeightScale [rule] v1.0.0

Set SF Symbol weight to match adjacent text weight; use the .small, .medium, or .large scale variants (imageScale) instead of explicit point sizes to size symbols relative to their text context.

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Applies To

all SF Symbols placed next to or within text labels

IosSfSymbolsWeightScale [rule] v1.0.0

Set SF Symbol weight to match adjacent text weight; use the .small, .medium, or .large scale variants (imageScale) instead of explicit point sizes to size symbols relative to their text context.

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Applies To

all SF Symbols placed next to or within text labels

Examples

• SwiftUI: Image(systemName: 'arrow.right').fontWeight(.semibold) next to Text('Continue').fontWeight(.semibold).
• Scale: Image(systemName: 'info.circle').imageScale(.small) for a compact inline icon, .large for standalone feature icons.
• Verify: inspect symbol alongside text; weights should appear visually harmonious.

Relations

related: [@community/rule-ios-sf-symbols-animations, @community/fact-ios-sf-symbols-rendering-modes, @community/rule-ios-dynamic-type-reflow]

Rationale

Mismatched weights create visual imbalance that signals unpolished design. Using text-relative scaling ensures symbols always pair correctly with their label, including at all Dynamic Type sizes.

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Applies To

all SF Symbols placed next to or within text labels