Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/madebybowtie/flagkit
Beautiful flag icons for usage in apps and on the web.
https://github.com/madebybowtie/flagkit
flag-icons flags icons ios macos tvos
Last synced: 30 days ago
JSON representation
Beautiful flag icons for usage in apps and on the web.
- Host: GitHub
- URL: https://github.com/madebybowtie/flagkit
- Owner: madebybowtie
- License: mit
- Created: 2015-08-19T18:35:42.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-19T11:11:58.000Z (7 months ago)
- Last Synced: 2024-05-16T00:24:13.994Z (6 months ago)
- Topics: flag-icons, flags, icons, ios, macos, tvos
- Language: Swift
- Homepage:
- Size: 64.8 MB
- Stars: 3,003
- Watchers: 54
- Forks: 319
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
![Header](Header.png)
# FlagKit
Beautiful flag icons for usage in apps and on the web. All flags are provided as stand-alone PNG and SVG files. FlagKit also provides an Asset Catalog and framework for easy use on Apple platforms.
## Installation (iOS, macOS, tvOS)
FlagKit provides a framework for easy installation as a dependency. You can also manually copy the Asset Catalog into your project.
### SwiftPM
Add the folowinig as repository URL:```
https://github.com/madebybowtie/FlagKit.git
```### Carthage
Add the following line to your `Cartfile`:```
github "madebybowtie/FlagKit"
```### CocoaPods
Add the following line to your `Podfile`:```
pod 'FlagKit'
```### Manual
Add `Assets/FlagKit.xcassets` to your target.## Usage (iOS, macOS, tvOS)
FlagKit provides both rectangular unstyled flags and styled flags in a variety of shapes. Our [sample project](Sources/Swift/FlagKitDemo-iOS) demonstrates how to display flags and customize them into different shapes (rounded corners, square, circle).> **Note:** Styling is currently not supported by FlagKit on macOS
This brief example loads the flag for the users current locale, and retrieves the unstyled flag and a styled flag:
```swift
let countryCode = Locale.current.regionCode!
let flag = Flag(countryCode: countryCode)!// Retrieve the unstyled image for customized use
let originalImage = flag.originalImage// Or retrieve a styled flag
let styledImage = flag.image(style: .circle)
```You can always access the underlying assets directly, through the bundled Asset Catalog:
```swift
let countryCode = Locale.current.regionCode!
let bundle = FlagKit.assetBundle
let originalImage = UIImage(named: countryCode, in: bundle, compatibleWith: nil)
```## Reference
FlagKit provides over 250 flags. A list of all flags can be [found here](Assets/Flags.md).
## More Info
Have a question? Please [open an issue](https://github.com/madebybowtie/FlagKit/issues/new)!
## License
FlagKit is released under the MIT license. See
[LICENSE](https://github.com/madebybowtie/FlagKit/blob/master/LICENSE).