{"id":33844383,"url":"https://github.com/renderhq/sf_symbols_typescript","last_synced_at":"2025-12-08T09:06:34.987Z","repository":{"id":261670381,"uuid":"884995236","full_name":"renderhq/sf_symbols_typescript","owner":"renderhq","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-08T02:39:36.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-19T10:09:46.646Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/renderhq.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-07T19:00:53.000Z","updated_at":"2024-11-08T02:39:40.000Z","dependencies_parsed_at":"2024-11-07T20:19:00.172Z","dependency_job_id":"064be918-ba3c-4051-8af1-1fb38ce4ae57","html_url":"https://github.com/renderhq/sf_symbols_typescript","commit_stats":null,"previous_names":["pawvan/sf_symbols_typescript","isafcck/sf_symbols_typescript","pawannnnn/sf_symbols_typescript","pawanjs/sf_symbols_typescript","manikupireddii/sf_symbols_typescript","pawanthegoat/sf_symbols_typescript","pawanchief/sf_symbols_typescript","pawanlifes/sf_symbols_typescript","pawanscales/sf_symbols_typescript","pavanscales/sf_symbols_typescript","renderhq/sf_symbols_typescript"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/renderhq/sf_symbols_typescript","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renderhq%2Fsf_symbols_typescript","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renderhq%2Fsf_symbols_typescript/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renderhq%2Fsf_symbols_typescript/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renderhq%2Fsf_symbols_typescript/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/renderhq","download_url":"https://codeload.github.com/renderhq/sf_symbols_typescript/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renderhq%2Fsf_symbols_typescript/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27593615,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-08T02:00:07.111Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-08T09:02:29.593Z","updated_at":"2025-12-08T09:06:34.964Z","avatar_url":"https://github.com/renderhq.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🍏 SF Symbols for TypeScript\n\n```ts\nimport type { SFSymbol } from 'sf-symbols-typescript'\n\nconst icon: SFSymbol = 'arrow.up'\n```\n\n\u003cimg style=\"border-radius: 8px; overflow: hidden; margin:0;\" width=\"1021\" alt=\"Screenshot 2023-03-03 at 3 21 13 PM\" src=\"https://user-images.githubusercontent.com/13172299/222821298-0c0a4fba-fe0a-4e31-85d7-55e7870f2bc7.png\" /\u003e\n\nA simple TypeScript utility to get the names of SF Symbols. Mainly useful for React Native libraries and apps that utilize SF Symbols.\n\n\n## Installation\n\n```sh\nyarn add sf-symbols-typescript\n```\n\n## Usage\n\n```ts\nimport type { SFSymbol } from 'sf-symbols-typescript'\n\nconst icon: SFSymbol = 'arrow.up'\n```\n\n## Restricting symbols\n\nBy default, this library exposes all available symbols for the current version of SF Symbols.\n\nDepending on the platforms your app targets, you may want to restrict the types to specific versions of SF Symbols.\n\n### Globally\n\nYou can restrict the `SFSymbol` type to a specific version of SF Symbols through declaration merging.\n\nThis library exposes an interface called `Overrides` with a property `SFSymbolsVersion` that can be overidden.\n\n```ts\ndeclare module 'sf-symbols-typescript' {\n  interface Overrides {\n    // globally restrict symbols to those found in SF Symbols 4.2\n    SFSymbolsVersion: '4.2'\n  }\n}\n```\n\n### Individually\n\nIf you require more granular control, this library also exposes individual type definitions for each version of SF Symbols.\n\nThey are named with this pattern: `SFSymbols{major}_{minor}`\n\n```ts\nimport type { SFSymbols4_2, SFSymbols5_0 } from 'sf-symbols-typescript'\n```\n\n### Version Support Table\n\nHere are the platforms supported by each version of SF Symbols:\n\n| SFSymbols | iOS  | macOS | tvOS | visionOS | watchOS |\n| --------- | ---- | ----- | ---- | -------- | ------- |\n| **1.0**   | 13.0 | 11.0  | 13.0 | 1.0      | 6.0     |\n| **1.1**   | 13.1 | 11.0  | 13.0 | 1.0      | 6.1     |\n| **2.0**   | 14.0 | 11.0  | 14.0 | 1.0      | 7.0     |\n| **2.1**   | 14.2 | 11.0  | 14.2 | 1.0      | 7.1     |\n| **2.2**   | 14.5 | 11.3  | 14.5 | 1.0      | 7.4     |\n| **3.0**   | 15.0 | 12.0  | 15.0 | 1.0      | 8.0     |\n| **3.1**   | 15.1 | 12.0  | 15.1 | 1.0      | 8.1     |\n| **3.2**   | 15.2 | 12.1  | 15.2 | 1.0      | 8.3     |\n| **3.3**   | 15.4 | 12.3  | 15.4 | 1.0      | 8.5     |\n| **4.0**   | 16.0 | 13.0  | 16.0 | 1.0      | 9.0     |\n| **4.1**   | 16.1 | 13.0  | 16.1 | 1.0      | 9.1     |\n| **4.2**   | 16.4 | 13.3  | 16.4 | 1.0      | 9.4     |\n| **5.0**   | 17.0 | 14.0  | 17.0 | 1.0      | 10.0    |\n| **5.1**   | 17.2 | 14.2  | 17.2 | 1.1      | 10.2    |\n\n## Contributing\n\nTo update this package's icons, you will need [Bun](https://bun.sh/) installed on your machine.\n\nYou will also need a copy of the plist resources from the [SF Symbols desktop application](https://developer.apple.com/sf-symbols/).\n\n- Right click the SF Symbols application in Finder and choose \"Show Package Contents\"\n- Navigate to `./Contents/Resources/Metadata`. The required plist resources are here.\n\nAlternatively, you may be able to find those same resource files in the source code of the unofficial [SFSafeSymbols Swift library](https://github.com/SFSafeSymbols/SFSafeSymbols/tree/stable/SymbolsGenerator/Sources/SymbolsGenerator/Resources).\n\n1. Clone this repo\n1. Copy the SF Symbols plist resource files into the `./src/data` directory of the repo\n1. Run `bun run build`\n1. Push your changes and open a PR\n\n## Disclaimer\n\nIt is your responsibility to check Apple's rules about when certain icons can be used. You can check [the SF Symbols desktop application](https://developer.apple.com/sf-symbols/) for more info.\n\nI am purposefully not displaying any icons themselves to avoid violating any licenses. This library isn't associated with Apple, and is only intended to expose the _names_ of the icons themselves\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenderhq%2Fsf_symbols_typescript","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frenderhq%2Fsf_symbols_typescript","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenderhq%2Fsf_symbols_typescript/lists"}