Doric: Design System Foundation
Design System foundation written in Swift. Protocol oriented, type safe, scalable framework for iOS.
- Colour Palette
- Dynamic scalable font support
- Auto layout
- Gradients, Shadows, Borders and other scales
- Layout spacing
- UI Debugging helpers
- API Document & Usage Documentation
- See DoricSnippet - BETA
- Generates Swift code snippets for Doric framework.
Not in specific orders to achieve it.
- Add debugging tools (Ruler etc.) [In progress]
- Expand framework to create more Styles
- Colour processing utilities
- Trait based layouts (UITraitCollection) [In progress]
- Accessibility for colour palettes
- Sketch plugin to generate palette. Try here
- See documentation
- iOS 11.0+
- Xcode 10.2+
- Swift 5
CocoaPods is an application level dependency manager for the Objective-C, Swift and any other languages that run on the Objective-C runtime that provides a standard format for managing external libraries. For usage and installation instructions visit site
Doric using CocoaPods, specify it in your
pod 'Doric', '~> 1.0.0'
Carthage builds your dependencies and provides you with binary frameworks, but you retain full control over your project structure and setup. Carthage does not automatically modify your project files or your build settings.
. To integrate
Doric into your Xcode project using Carthage, specify it in your
github "jayeshk/Doric" ~> 1.0.0
If you can integrate project manually as below using git submodule
Open up Terminal,
cdinto your top-level project directory, and run the following command "if" your project is not initialised as a git repository:
$ git init
Add Doric as a git submodule by running the following command:
$ git submodule add https://github.com/jayeshk/Doric.git
Open the new
Doricfolder and drag the
Doric.xcodeprojinto the Project Navigator.
It should appear nested underneath your application's blue project icon. Whether it is above or below all the other Xcode groups does not matter.
Doric.xcodeprojin the Project Navigator and verify the deployment target matches that of your application target.
Next, select your application project in the Project Navigator to navigate to the target configuration window and select the application target under the "Targets" heading in the sidebar.
In the tab bar at the top of that window, open the "General" panel.
Click on the
+button under the "Embedded Binaries" section.
You will see
Doric.frameworknested inside a
Productsfolder. Select the
You can verify which one you selected by inspecting the build log for your project. The build target for
Doricwill be listed as
Doric.frameworkis automagically added as a target dependency, linked framework and embedded framework in a copy files build phase which is all you need to build on the simulator and a device.
Doric is open to contribute, see contribution notes.
- If you want to contribute, submit a pull request.
- If you found a bug, open an issue.
- If you need help with a feature or need to discuss best practices please see usage document , still anything to discuss contact me (firstname.lastname@example.org).
About Doric name?
The Doric order was one of the three orders of ancient Greek and later Roman architecture, Doric is named based Doric_order. Hence provides pillars for your digital products.
Why Design System required?
As the number of devices screen variants and environments are increasing, so there is need to create scalable interface Design Systems.
Doric's primary goal is to create a system which allows you to manage design at scale for iOS. Consistency, scalability and efficiency across app are focused areas. See Awesome Design Systems
It is required to implement all parts of Doric?
Doric provides various building blocks to implement interface. All blocks can be used independently or can be composed as needed. For example your app can use Typography only or Color Palettes. Better practice would be compose all them into single Design System.
It also allows you to use any of these blocks with other third part frameworks. For example Spacing and Layout can be used any other third party frameworks.
Since it protocol oriented framework you can further extended any of section and customise it. Doric comes with few default implementations. See more for usage guide
Doric is influenced by various Design System guidelines and many stackoverflow posts.
Major source of inspiration Atomic Design
Brad Frost, author of Atomic Design : “comprehensive collection of the bits and pieces that make up your interface”.
Doric is released under the MIT license. See LICENSE for details.