The objective of this library is to provide all the utilities we need to create UI for the SATS member app by implementing the design system we use, then when building UI we just care of combining this basic elements rather than re-invent everything and also to provide a solid base that allows support to advanced UI features like: dark mode, dynamic types and so on.
This library defines Fonts, Colors and other base components and configurations to create UI. This applies to both
⚠️ We opted to create this library directly as an SPM package, since we believe is the future way of handling packages over CocoaPods. This has benefits as well tradeoffs.
AppDelegate you should call
This will register the custom fonts and can be used to customize library options.
Since the library provides both
SwiftUI utilities, we need to avoid names like
Button as they will clash with SwiftUI’s types. In the case of UIKit, the way to define text and buttons would be respectively to use:
Both components come already configured with the styles defined in the new design system. There may still be some designs that have not been ported to the new style, so we will do this gradually.
To use fonts, you can do
Text("Hello World") .satsFont(.h1)
.satsFont is a method as you can invoke it like
.satsFont(.h1, weight: .emphasis) for a semi-bold variation of the semantic
To use colors part of the design system, we have included a bunch of extensions to
Color respectively, which define all the semantic colors we should use. We should never use a color by name, like
Color.white, instead we can use:
Color.backgroundPrimary Color.backgroundSecondary Color.buttonPrimary Color.onPrimary // text or icons on top of button primary color Color.selection Color.waitlist // etc.
UIKit this would be a common scenario
view.backgroundColor = .backgroundSecondary // UIColor.backgroundSecondary
If you want to edit the package on its own you can just open
Package.swift, which will open the package in stand-alone mode in Xcode.
The best way to develop the package is to open the demo app Xcode project
~/Code/SATSCore$ xed DemoApp
This is one of the tradeoffs of using SwiftPackageManager, in standalone packages we cannot have demo apps, neither configure Xcode to run SwiftLint. So we added this to the DemoApp.
In order to release a new version of the package (and SATSCore iOS app)
Create a PR for your improvements
Merge your PR to main
Get latest released version from the releases section
Get the changelog from the latest version which in this case is
1.3.0for the last released version of the package.
gem install pr_changelog), you can run a command like
$ pr_changelog 1.3.0 main --format pretty | pbcopy
On the releases section click the
Draft a new release button
Create a tag - which in this case is
Choose a tag
Titleof the release is in the form
0.0.8or similar as this number is used by SPM(Swift Package Manager) to define the version.
Release title with the newly created tag -
Paste changelog into the description field
Check on the
Set as the latest release
You are done 😄, now you can update the package where it's used
|Last commit: 3 days ago|
Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics