Detta är ett delat Swift Package för våra iOS-appar.
Syftet är att tillhandahålla generiska, design/figma-kompatibla UI-komponenter, färger och typografi – allt för att förenkla utveckling, förbättra konsekvens och minska duplicerad kod.
Alla komponenter är prefixed med VGR
(t.ex. VGRButton
, VGRCallout
) för att undvika krock med inbyggda SwiftUI-komponenter och andra externa ramverk.
Lägg enkelt till det som ett Swift Package i ditt Xcode-projekt:
- Gå till File > Add Package Dependencies
- Klistra in GitHub-URL:
https://github.com/Vastra-Gotalandsregionen/designsystem-ios.git
- Add Package
- Importera det i kod:
import designsystem
Vill du utveckla komponenter eller förbättra designsystemet? Följ dessa steg:
- Lägg till det klonade repo:t som ett local Swift Package i Xcode (File > Add Package Dependencies > Add Local Package...)
- Peka på din klonade mapp (
designsystem-ios
)
Nu kan du se och redigera komponenterna direkt från din app.
git checkout -b feat/namn-på-förändring
- Bygg och testa i din app med det lokala paketet kopplat.
- Lägg till nya previews där det är relevant.
Gör en PR mot main
via GitHub, begär kodgranskning.
Komponenter bör ha tydliga #Preview
-block för att enkelt kunna testas i Xcode.
Alla komponenter använder prefixet VGR
för att undvika konflikter med standardbiblioteket eller tredjepartspaket:
- ✅
VGRButton
- ✅
VGRCallout
- ✅
VGRStepper
Undvik att skapa komponenter utan prefix – även för interna strukturer om de kan användas externt.