• Stars
    star
    241
  • Rank 167,643 (Top 4 %)
  • Language
    Swift
  • License
    Other
  • Created over 7 years ago
  • Updated about 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

๐Ÿ‘•๐Ÿ‘š Theme management in Swift

Themes

CI Status Version Carthage Compatible License Platform Swift

Story

Ever want to support Night mode? Or skin the app differently depending on the seasons? Or toggle features according to paid status? Well, those are actually reactions to app events.

Many other frameworks encourage you to use hard coded values, like label.xyz_textColors = [.red, .blue], textField.xyz_fonts = [font1, font2], .... This also makes it very hard to change because the usage of index, you need to remember that the 1st index is this theme, the 2nd index is that theme, ... Also, xyz_textColors is like trying to replicate the entire UIKit APIs, which updates often ๐Ÿ˜ฑ

Themes is here to help. Usually, you have a finite number of colors and fonts in an app. You can have many more but that is not encourage and has design smells. When you have a theme, changing happens in one place.

Features

  • Universal support for iOS, macOS, tvOS, watchOS
  • Complete control over themes
  • Update existing views
  • Protocol oriented
  • Extensible

Usage

Step 1: Create a theme

Declare your theme by conforming to Theme, which is just a marker protocol. You can declare whatever you like, including nested objects, all depending on your need. You can also create as many themes as you like

struct MyTheme: Theme {
  let topImage: UIImage
  let cellColor: UIColor
  let backgroundColor: UIColor
  let name: String
  let titleFont: UIFont
  let subtitleFont: UIFont
}

Then create some themes based on your templates

let dayTheme = MyTheme(topImage: UIImage(named: "day"), cellColor: .white)
let nightTheme = MyTheme(topImage: UIImage(named: "night"), cellColor: .black)

The beauty of this is that you can init your theme from json, which can be fetched from backend ๐Ÿš€

let json = [
  "primary_color": "#21ABE9",
  "font_name": "Chewy"
]
let unicornTheme = MyTheme(json)

Step 2: Register your current theme

When app launches, you need to declare 1 theme as the current, it can be loaded from cache

ThemeManager.shared.currentTheme = dayTheme

Step 3: React to theme change

You can do this wherever you like. It is set using the current theme, and whenever theme changes

// ViewController.swift
override func viewDidLoad() {
  super.viewDidLoad()

  use(MyTheme.self) {
    $0.title = $1.name
    $0.tableView.backgroundColor = $1.backgroundColor
    $0.navigationController?.navigationBar.setBackgroundImage($1.topImage, for: .default)
    $0.tableView.rowHeight = $1.name == "Unicorn" ? 180 : 120
    $0.tableView.reloadData()
  }
}

// Cell.swift
override func awakeFromNib() {
  super.awakeFromNib()

  imageView.layer.cornerRadius = 5
  imageView.layer.masksToBounds = true

  use(MyTheme.self) {
    $0.titleLabel.font = $1.titleFont
    $0.subtitleLabel.font = $1.subtitleFont
    $0.container.backgroundColor = $1.cellColor
  }
}

Step 4: Change the theme

Change the current theme is as easy as assigning a new theme. All happens in real time and very fast

ThemeManager.shared.currentTheme = nightTheme

Installation

Themes is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Themes'

Themes is also available through Carthage. To install just write into your Cartfile:

github "onmyway133/Themes"

Themes can also be installed manually. Just download and drop Sources folders in your project.

Author

Khoa Pham, [email protected]

Contributing

We would love you to contribute to Themes, check the CONTRIBUTING file for more info.

License

Themes is available under the MIT license. See the LICENSE file for more info.

More Repositories

1

awesome-ios-animation

โ˜” A collection of iOS animation repos
5,305
star
2

awesome-ios-architecture

๐Ÿฏ Better ways to structure iOS apps
5,056
star
3

PushNotifications

๐Ÿ‰ A macOS, Linux, Windows app to test push notifications on iOS and Android
JavaScript
2,230
star
4

DeepDiff

๐Ÿฆ€Amazingly incredible extraordinary lightning fast diffing in Swift
Swift
2,049
star
5

IconGenerator

๐Ÿฑ A macOS app to generate app icons
JavaScript
1,403
star
6

RoughSwift

๐ŸŽƒ Create hand-drawn, sketchy, comic shape in Swift
Swift
1,104
star
7

FinderGo

๐Ÿข Open terminal quickly from Finder
Swift
1,084
star
8

Snowflake

โ„๏ธ SVG in Swift
Swift
956
star
9

GifCapture

๐Ÿ‡ Gif capture app for macOS
Swift
916
star
10

awesome-machine-learning

๐ŸŽฐ A curated list of machine learning resources, preferably CoreML
794
star
11

Swiftlane

๐Ÿš€ Build utilities in pure Swift
Swift
692
star
12

blog

๐Ÿ What you don't know is what you haven't learned
666
star
13

awesome-swiftui

๐ŸŒฎ Awesome resources, articles, libraries about SwiftUI
642
star
14

EasyConfetti

๐ŸŽŠ Fancy confetti effects in Swift
Swift
561
star
15

XcodeWay

โ›ต An Xcode Source Editor Extension that helps navigating to many places easier
Swift
550
star
16

Smile

๐Ÿ˜„ Emoji in Swift
Swift
512
star
17

EasyAnchor

โš“๏ธ Declarative, extensible, powerful Auto Layout
Swift
455
star
18

EasyStash

๐Ÿ—ณEasy data persistence in Swift
Swift
377
star
19

Scale

๐ŸŽ Unit converter in Swift
Swift
323
star
20

EasyDropdown

๐Ÿ’ง Fantastic dropdown in Swift
Swift
309
star
21

XcodeColorSense2

๐Ÿ‰ An Xcode source editor extension that shows hex color info
Swift
285
star
22

Arcane

๐Ÿ”ฑ CommonCrypto in Swift, and more
Swift
283
star
23

awesome-android-animation

๐Ÿ’ฆ A collection of Android animation repos
Java
253
star
24

awesome-voip

๐Ÿค™Learning VoIP, RTP, pjsip and SIP
237
star
25

SwiftHash

๐Ÿ• MD5 in pure Swift
Swift
215
star
26

EasyClosure

๐Ÿฉ Unified communication patterns with easy closure in Swift
Swift
201
star
27

Github.swift

:octocat: Unofficial GitHub API client in Swift
Swift
186
star
28

emoji

โค๏ธ List of emojis
Swift
163
star
29

SwiftSnippets

๐Ÿฎ A collection of Swift snippets to be used in Xcode
Shell
162
star
30

Wave

๐ŸŒŠ Declarative chainable animations in Swift
Swift
127
star
31

awesome-online-earning

๐Ÿ’ฐWays to earn extra
124
star
32

Spek

๐ŸŽ Function builder BDD testing framework in Swift
Swift
122
star
33

FontAwesomeSwiftUI

Easy to use FontAwesome 5 in SwiftUI
Swift
97
star
34

Recipes

๐ŸฃMaking Recipes iOS app
Swift
91
star
35

MathSolver

โŒจ๏ธCamera calculator with Vision
Swift
87
star
36

XcodeColorSense

๐ŸŽˆ An Xcode plugin that makes working with color easier
Swift
77
star
37

Micro

๐ŸŽFast diffing and type safe SwiftUI style data source for UICollectionView
Swift
76
star
38

Omnia

๐Ÿ—ฟ Everything your projects need to know
Swift
62
star
39

notes

๐Ÿ“” Issues and solutions I found during development, mostly iOS
62
star
40

Sketch-Action

๐Ÿ”Ž A Sketch plugin to simulate Spotlight
Objective-C
59
star
41

MainThreadGuard

๐Ÿ’‚โ€โ™‚๏ธ Tracking UIKit access on main thread
Swift
58
star
42

EasyFake

๐Ÿคนโ€โ™€๏ธ Fake data generation in Swift
JavaScript
57
star
43

Reindeers

โ„๏ธ XML and HTML parser in Swift
Swift
55
star
44

awesome-git-commands

๐Ÿด Indispensable git commands for everyday use
55
star
45

RxLifeCycle

๐Ÿน Easy life cycle observation
Swift
53
star
46

Upstream

โ›ฒ๏ธ Adapted Data Source in Swift and a little bit more
Swift
53
star
47

BigBigNumbers

๐Ÿ”ขSay the number out loud
Swift
49
star
48

GifMagic

๐Ÿ’ˆ Gif maker and extractor in Swift
Swift
48
star
49

awesome-android-architecture

๐Ÿฐ Better ways to structure Android apps
45
star
50

AppStoreConnect

๐ŸŽ Interact with AppStoreConnect
Swift
45
star
51

TestTarget

๐Ÿณ Notes on configuring test targets
Swift
44
star
52

PhotoFeed

๐Ÿ›ต Instagram in Swift 4
Swift
43
star
53

awesome-conference-videos

๐ŸŽธ Conference videos. Visit http://learntalks.com/
40
star
54

CollectionUpdateExample

๐Ÿ›ถ Demo batch update in UITableView and UICollectionView
Swift
38
star
55

Construction

๐Ÿ‘ท The many ways to construct and configure your entity
Swift
34
star
56

PastePal

PastePal is the best universal clipboard manager for Mac, iPhone and iPad.
31
star
57

github-extended

:octocat: A Chrome extension to discover more repositories
JavaScript
30
star
58

EasyNetworking

๐Ÿ›ฐEasy networking with async/await
Swift
28
star
59

Runtime-Headers

๐Ÿ’ฟ iOS, macOS runtime headers
Objective-C
28
star
60

UsingPlayground

๐Ÿ‘ถ Demo how to use Playground
Swift
26
star
61

EasySwiftUI

๐Ÿฐ Extra sugar for SwiftUI
Swift
25
star
62

Farge

๐ŸŽˆTell the name of hex color
Swift
24
star
63

Avengers

๐Ÿ‘พDemo how to use CoreML with IBM Watson, Azure Custom Vision, Turi Create
Swift
21
star
64

ISO8601

๐ŸŽ— Super lightweight ISO8601 Date Formatter in Swift
Swift
21
star
65

SlidingMenu

๐ŸŽฟ Demo how to create sliding menu on Android
Java
20
star
66

Paramount

๐Ÿ—ผ Like Flipboard FLEX, but allows custom action
Swift
20
star
67

Codelime

Codelime is a powerful code snippet manager with many dev tools for iOS development.
19
star
68

DynamicTableViewCellHeight

๐ŸŸ Demo how to use Autolayout to make varying row height
Objective-C
18
star
69

github-chat

๐Ÿ’ฌ A Chrome extension to enable chat within GitHub
JavaScript
18
star
70

Resolver

๐ŸŽŠ A simple resolver in Swift
Swift
15
star
71

archives

๐Ÿšฃ Only deliberate practice will make you better
Objective-C
14
star
72

ParticlePlayground

๐ŸŽŠ A Swift playground to play with CAEmitterLayer
Swift
14
star
73

json_resolve

๐ŸฐEasy resolving deep json using keypath in Dart
Dart
12
star
74

Then

๐Ÿƒ Promise A+ in Swift
Swift
11
star
75

LighterAppDelegate

๐ŸŽฃ Lighter AppDelegate by dispatching events
Swift
10
star
76

Xkcd

๐Ÿฆ„ Simple Xkcd iOS app
Swift
8
star
77

Border

๐Ÿ“ Make border for all views
Swift
8
star
78

Xmas

๐ŸŽ… ๐ŸŽ„ โ›„ Xmas plugin for Xcode
Objective-C
7
star
79

github-changelogs-maker

๐Ÿป Generate changelogs between 2 latest releases
JavaScript
7
star
80

linphone-iphone

Forked from linphone.org
Objective-C
7
star
81

EasyTracker

๐Ÿ•ต๏ธ Trackers in Swift
Swift
6
star
82

FantasticDisplay

๐ŸŽข Fantastic HUD and toast in Swift
Swift
6
star
83

ComputerScienceSwift

๐Ÿ‘จโ€๐Ÿ’ป Practice computer science in Swift
Swift
6
star
84

PushHero

Push Hero is a native macOS application written in pure Swift that allows us to easily test push notifications
6
star
85

onmyway133

What you don't know is what you haven't learned
5
star
86

Minion

๐Ÿ Working with Xcode plugins
Swift
5
star
87

SketchHeaders

๐Ÿ’ฟ Headers from Sketch
Objective-C
4
star
88

homebrew-formulae

๐Ÿš— Homebrew formulae
Ruby
3
star
89

chat_webrtc

โŒจ๏ธ Simple chat application using Node.js and WebRTC Data Channel
JavaScript
3
star
90

DarkSide

๐ŸŒŒ My dark theme based on Atom One Dark
Shell
3
star
91

android-architecture-components-kotlin

๐Ÿฅ‹ Samples for Android Architecture Components in Kotlin
Kotlin
2
star
92

slackbot-yoda

๐Ÿ’ Slackbot Yoda
JavaScript
2
star
93

onmyway133.github.io

Showcase
HTML
2
star
94

traffic_simulator

๐Ÿš— Traffic simulator using enchant.js
JavaScript
2
star
95

rtpproxy

๐Ÿฅ‚ Forked from http://www.rtpproxy.org/ with IP handover support
C
2
star
96

Shipmunk

Search, bookmark and track keyword rating for your favorite apps
2
star
97

Dust

๐Ÿš€ Unofficial, simple push notification
Swift
1
star
98

MarqueeTextBlock

๐ŸŒด How to make marquee TextBlock on Windows Phone
C#
1
star