Important
This current version of Vitamin will no longer evolve and only accept bug fixes from now on. More details here.
Vitamin iOS
Decathlon Design System libraries for iOS & iPadOS applications
Introduction
Decathlon Design System is the framework that helps our ecosystem to design and develop consistent and quality experiences.
For its Digital section, it is called Vitamin.
Install
SPM
Add Vitamin to the dependencies array of your package:
dependencies: [
.package(url: "https://github.com/Decathlon/vitamin-ios.git", .exact("0.13.0")),
// Any other dependencies...
],
Then, add Vitamin to the dependencies array of any target that depends on Vitamin.
For SwiftUI
:
.target(name: "YourSwiftUITarget",
dependencies: [
.product(name: "VitaminSwiftUI", package: "vitamin-ios"),
// Any other dependencies...
]),
For UIKit
:
.target(name: "YourUIKitTarget",
dependencies: [
.product(name: "Vitamin", package: "vitamin-ios"),
// Any other dependencies...
]),
A full example:
let package = Package(
name: "YourPackage",
products: [
// Your products
],
dependencies: [
.package(url: "https://github.com/Decathlon/vitamin-ios.git", .exact("0.13.0")),
// Any other dependencies...
],
targets: [
// Your target
.target(name: "YourUIKitTarget",
dependencies: [
.product(name: "Vitamin", package: "vitamin-ios"),
// Any other dependencies...
]),
.target(name: "YourSwiftUITarget",
dependencies: [
.product(name: "VitaminSwiftUI", package: "vitamin-ios"),
// Any other dependencies...
]),
]
)
Cocoapods
# for UIKitVersion
pod 'Vitamin', '= 0.13.0'
# for SwiftUI version
pod 'VitaminSwiftUI', = '0.13.0'
Available elements
This library provides two types of elements: Foundations and Components.
Foundations are core bricks of Vitamin Design System, and Components are high level elements, built upon Foundations.
Foundations
The following foundations are available :
Element | Description | Documentation |
---|---|---|
Assets | Set of graphic assets usable in the Design System. | UIKit SwiftUI |
Colors | Semantics and base colors of the Design System. | UIKit SwiftUI |
Icons | Set of icons usable in the Design System. | UIKit SwiftUI |
Radiuses | Radiuses applicable to any view in the Design System. | UIKit SwiftUI |
Shadows | Shadows applicable to any view in the Design System. | UIKit SwiftUI |
Typography | Text styles usable in the Design System. | UIKit SwiftUI |
Components
The following components are available :
Component | Description | Documentation |
---|---|---|
Badge | Badges from the Vitamin Design System. | UIKit SwiftUI |
Button | Different button styles from the Vitamin Design System. | UIKit SwiftUI |
Progressbar | Different progressbar styles from the Vitamin Design System. | UIKit |
SegmentedControl | SegmentedControl from the Vitamin Design System. | UIKit |
Snackbar | Snackbar from the Vitamin Design System. | UIKit |
Switch | Switch from the Vitamin Design System. | UIKit |
Tag | Tag from the Vitamin Design System. | UIKit |
TextField | Different text fields styles from the Vitamin Design System. | UIKit SwiftUI |
Special thanks
Thank you to the contributors involved in these vitamin-ios libraries (even before they were Open Source). 💙
Thank you also Remix Icon because Vitamix Icons is the official Decathlon icon library based on their open-source icon library (Remix Design © 2020). This original library is under the license Apache 2.0 and has been modified by Decathlon. Learn more.
License
Copyright 2021 Decathlon.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.