symbolist

? A collection of every symbol from SF Symbols.

• ? Automated: Authored and updated automatically
• ? Reliable: Fully tested with 100% code coverage
• ? Typed: Written in TypeScript and includes definitions out-of-the-box
• ? Zero dependencies

Introduction

SF Symbols is a library of iconography from Apple, integrated into the San Francisco system fonts.

Installation

npm install symbolist

Usage

symbols

Import symbols.

import { symbols } from "symbolist"

// symbols: {"0.circle": "?", "0.circle.fill": "?", ...}

getSymbol

Import getSymbol.

import { getSymbol } from "symbolist"

Given a symbol name, getSymbol will return its symbol (or undefined for unknown symbols).

const symbol = getSymbol("scribble.variable")

// symbol: "?"

getSymbolName

Import getSymbolName.

import { getSymbolName } from "symbolist"

Given a symbol, getSymbolName will return its name (or undefined for unknown symbols).

const name = getSymbolName("?")

// name: "lasso.and.sparkles"

Automation

Symbols are extracted with the generate command—using the SF Symbols app.

Types

generate prepares types along its symbols which means getSymbol and getSymbolName will validate symbol names when using TypeScript.

Versioning

This package follows SF Symbols' versioning for major and minor versions.