Swiftpack.co - sats-group/SATSCore-iOS as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by sats-group.
sats-group/SATSCore-iOS push
A library that implements the core in design system for the iOS app
⭐️ 8
🕓 1 week ago
iOS tvOS
.package(url: "https://github.com/sats-group/SATSCore-iOS.git", from: "push")


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 UIKit and SwiftUIbased UI.

⚠️ 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.


import SATSCore

In AppDelegate you should call


This will register the custom fonts and can be used to customize library options.


Since the library provides both UIKit and SwiftUI utilities, we need to avoid names like Label or 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:

  • SATSButton
  • SATSLabel

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 is a method as you can invoke it like .satsFont(.h1, weight: .emphasis) for a semi-bold variation of the semantic H1 text.


To use colors part of the design system, we have included a bunch of extensions to UIColor and 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.onPrimary // text or icons on top of button primary color
// etc.

In 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)

  1. Create a PR for your improvements

  2. Merge your PR to main

  3. Get latest released version from the releases section

  4. Get the changelog from the latest version which in this case is 1.3.0

    • Remember to replace 1.3.0 for the last released version of the package.
    • If you have pr_changelog installed (gem install pr_changelog), you can run a command like
     $ pr_changelog 1.3.0 main --format pretty | pbcopy
  5. On the releases section click the Draft a new release button

The Release

  1. Create a tag - which in this case is 1.3.1

    • You can do this from the dropdown button - Choose a tag
    • Make sure the Tag and Title of the release is in the form 0.0.8 or similar as this number is used by SPM(Swift Package Manager) to define the version.
  2. Fill in Release title with the newly created tag - 1.3.1

  3. Paste changelog into the description field

  4. Check on the Set as the latest release

  5. Publish release

You are done 😄, now you can update the package where it's used


Stars: 8
Last commit: 3 days ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

4 days ago

Changes since 6.0.0 to main (merge)


  • #137: 💎 Rounded rectangle buttons

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics