Orbit SwiftUI is a component library that provides developers an easy way of building Kiwi.com’s products.
Orbit aims to bring consistency to our products and processes.
Orbit is an open-source design system created for specific needs of Kiwi.com.
This library allows you to integrate it into your iOS SwiftUI project.
- iOS 13
- Xcode 15
- Swift Package Manager
Add Orbit package to your project by adding the package dependency:
.package(name: "Orbit", url: "https://github.com/kiwicom/orbit-swiftui.git", .upToNextMajor(from: "0.10.0")),
The online documentation contains instructions on how to get started with the library as well as examples and pages for individual components.
You can also build the documentation locally in Xcode (Product -> Build Documentation).
The Orbit Storybook that contains a showcase of Orbit foundation and components can be built in Xcode or downloaded as a standalone app in the App Store.
Feel free to create bug reports and feature requests via the Issues tab.
If you want to directly contribute by fixing a bug or implementing a feature or enhancement, you are welcome to do so. Pull request review has following priorities to check:
- API consistency with other components (similar components should have similar API)
- Component variants matching design variants (components should have same properties as design)
- Visual match to designs
- Internal code structure consistency (button-like components should use consistent mechanism, haptics etc.)
- Previews / Storybook consistency (a new component needs to be added to the Storybook)
We want to provide high quality and easy to use components. We can’t do that without your feedback. If you have any suggestions about what we can do to improve, please report it as an issue.