KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #react #mcp #rust

Awesome

★ 104 Open GitHub ↗

FontAwesome 6 Swift & SwiftUI implementation for iOS, tvOS & macOS

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Awesome

[![Font Awesome](https://img.shields.io/badge/Font%20Awesome-6.0.0-brightgreen.svg)](https://fontawesome.com/v6.0.0/icons)
[![Slack](https://img.shields.io/badge/join-slack-745EAF.svg?style=flat)](http://bit.ly/2B0dEyt)
[![Version](https://img.shields.io/cocoapods/v/AwesomeEnum.svg?style=flat)](http://cocoapods.org/pods/AwesomeEnum)
[![License](https://img.shields.io/cocoapods/l/AwesomeEnum.svg?style=flat)](http://cocoapods.org/pods/AwesomeEnum)
[![Platform](https://img.shields.io/cocoapods/p/AwesomeEnum.svg?style=flat)](http://cocoapods.org/pods/AwesomeEnum)

Super easy to use library containing the brand new Font Awesome 6, completely redesigned for Swift 5

## Slack

Get help using and installing this product on our [Slack](http://bit.ly/2B0dEyt), channel <b>#help-awesome</b>

## Installation

Awesome is available through [CocoaPods](http://cocoapods.org). To install it, simply add the following line to your Podfile:

```ruby
pod 'AwesomeEnum'
```

for Carthage just add:

```ruby
github "LiveUI/Awesome"
```

for Swift Package Manager

You can add in your project settings under Swift Packages or  File -> Swift Packages -> Add Package to enter the following url and select version to complete.

```
https://github.com/LiveUI/Awesome
```

If you want to add in package.swift manifest file add under dependencies.

```swift
.package(url "https://github.com/LiveUI/Awesome", from: 2.0.0)
```

## Usage

Import will be slightly different for Cocoapods/Carthage/SPM. Sorry for the confusion of names but some unreasonable fellow has already registered an `Awesome` pod before us :).

### Cocoapods

```swift
import AwesomeEnum
```
### Carthage

```swift
import Awesome
```

### Swift Package Manager

```swift
import Awesome
```

All icons are available through autogenerated enums like this:

```swift
// UKit and AppKit
let image = Awesome.Solid.handScissors.asImage(size: 40.0)
// or
let image = Awesome.Brand.android.asImage(size: CGSize(width: 40, height: 40), color: .red, backgroundColor: .blue) // :trollface:
// or
let attributedText = Awesome.Regular.envelopeOpen.asAttributedText(fontSize: 17, color: .red, backgroundColor: .blue)

// SwiftUI
Awesome.Brand.apple.image
// Set some modifiers
Awesome.Brand.android.image
	.size(40)
	.foregroundColor(.red)
	.backgroundColor(.blue)
// Scales automatically with font
Awesome.Brand.android.image
    .foregroundColor(.red)
    .backgroundColor(.blue)
    .font(.largeTitle)
// or
Awesome.Image(icon: Awesome.Brand.apple)
```

### Font Awesome Pro

The Font Awesome Free files are included and loaded for you out of the box. Font Awesome Pro licensing terms don't allow to publish the font files however, so we can't add those for you. As such you will need to manually add the fonts to your project and register them before using them:

```swift
// AppDelegate application(_:didFinishLaunchingWithOptions:)

// Load all fonts
AwesomePro.loadFonts(from: Bundle.main)

// Load only some fonts
AwesomePro.loadFonts(from: Bundle.main, only: [.brand, .solid])

//For registering fonts use Bundle.module
let resourceURLString = Bundle.module.url(forResource: fontName, withExtension: nil)
```

The filenames have to match Font Awesome's naming scheme (`fa-brands-400.ttf`, `fa-light-300.ttf`, `fa-regular-400.ttf`, `fa-solid-900.ttf`). You only have to include the fonts you are using.

Once the fonts are registered you can use the `AwesomePro` enum just as you'd use the `Awesome` enum, except that you now have access to all Font Awesome Pro icons.

## Contributors

- **Author**: Ondrej Rafaj , development@mangoweb.cz
- Christopher Mühl , christopher@padarom.io
- David Walter, hi@davidwalter.at
- Georg von der Howen, georg@beaconeer.com

## License

Awesome is available under the MIT license. See the [LICENSE](LICENSE) for more info. All fonts are property of Font Awesome!

Awesome

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README