# SFSafeSymbols/SFSafeSymbols

Safely access Apple's SF Symbols using static typing

Repository: https://github.com/SFSafeSymbols/SFSafeSymbols
Canonical: https://ross.abutalabs.com/products/sfsafesymbols
Language: Swift
License: MIT
License Family: permissive
Topics: swift, icons, symbols, ios, sfsymbols
Last push: 2026-03-31T21:33:29+00:00

## Health v2 (maintenance only)
Score: 61/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 75, release rhythm 22, longevity 100
- inputs: {"age_days": 2647, "days_push": 155, "days_rel": 311, "gap_med": 245, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1890, forks 75 (observed 2026-08-28T04:05:49.517298+00:00)

## What it is
A Swift library that provides type-safe, statically-typed access to Apple's SF Symbols icon library, avoiding crash-prone string-based lookups. All symbols are validated via CI across iOS, tvOS, watchOS, and macOS versions.

## Use cases
- reference SF Symbols icons without typos in Swift
- avoid crashes from invalid SF Symbol names
- get compile-time safety for icon names in iOS apps
- use SF Symbols across iOS, macOS, watchOS and tvOS
- replace unsafe UIImage(systemName:) string lookups

## When to choose
- you build Apple-platform apps in Swift and use SF Symbols icons
- you want compile-time checking of symbol names and availability
- you support multiple Apple OS versions and need availability safety

## When to avoid
- you develop outside Apple platforms or in non-Swift languages
- you only use custom icon assets instead of SF Symbols

## Facets
- artifact type: library
- maturity: active
- function: ui-components, developer-tools
- domain: apple-ecosystem, mobile-development, cross-platform
- platform: -
- tags: sf-symbols, icons, type-safety, swift-package, ios, macos, swift

## Member repositories
- SFSafeSymbols/SFSafeSymbols (main) score 61

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:49.517298+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:13:00.997939+00:00, confidence not recorded.
  - readme: https://github.com/SFSafeSymbols/SFSafeSymbols (fetched 2026-08-28T04:05:49.517298+00:00, sha e23820897540)
- Data as of 2026-08-30T08:39:29.467469+00:00.