How do I install Doric in my Xcode project?

You can use CocoaPods by adding 'pod "Doric", "~> 1.0.0"' to your Podfile, or use Carthage or manual installation as detailed in the README. The framework supports iOS 11.0+ and Swift 5 for seamless integration.

Doric vs. SwiftUI: which is better for design systems?

Doric is UIKit-focused and provides a protocol-oriented, type-safe foundation for scalable design systems, while SwiftUI offers built-in design tools but less emphasis on structured design tokens. Choose Doric for large-scale, maintainable systems in UIKit projects.

Can Doric handle dark mode and dynamic themes?

Yes, Doric includes theme support that allows easy switching between visual themes, which can be adapted for dark mode by defining color palettes and styles dynamically, ensuring consistency across user preferences.

What are the performance costs of using Doric?

Doric adds minimal overhead as it primarily manages design tokens at compile time with type-safe APIs. However, extensive use of protocols and dynamic fonts might have slight runtime impacts, but it's optimized for typical iOS app performance.

How do I customize typography scaling with Doric?

Use Doric's type-safe typography APIs to define font styles with dynamic scaling support, allowing fonts to adjust based on user settings. Refer to the usage documentation for examples on implementing scalable text across your app.

Is Doric suitable for small iOS apps or only large projects?

Doric is designed for scalability, so for small apps with simple UI, it might be overkill. It's best suited for projects where design consistency, future growth, and maintainability are key priorities.

Open-Awesome

Doric Design System Foundation

NOASSERTIONSwift

A protocol-oriented, type-safe Swift framework for building scalable design systems on iOS.

GitHub

101 stars21 forks0 contributors

What is Doric Design System Foundation?

Doric is a Swift framework for iOS that provides a protocol-oriented, type-safe foundation for building design systems. It helps developers manage UI components like typography, colors, and layouts in a scalable and consistent way. The framework solves the problem of maintaining design consistency across large iOS applications with multiple screen variants and environments.

Target Audience

iOS developers and teams building scalable applications who need a structured approach to design consistency. It's particularly useful for projects with complex UI requirements or those adopting design system methodologies.

Value Proposition

Developers choose Doric for its type-safe, protocol-oriented architecture that ensures scalability and reduces bugs. Unlike generic UI libraries, it offers a dedicated foundation for design systems with built-in debugging tools and seamless integration into existing iOS projects.

Overview

Protocol oriented, type safe, scalable design system foundation swift framework for iOS.

Use Cases

Best For

Building consistent typography and color systems across iOS apps
Implementing atomic design principles in Swift projects
Managing scalable design tokens for large mobile applications
Creating theme-switching capabilities in iOS interfaces
Developing UI components with type-safe property definitions
Teams adopting design system methodologies for iOS development

Not Ideal For

Teams needing pre-styled, drop-in UI components without custom implementation work
Cross-platform projects where design consistency must be shared between iOS and Android using a single framework
Legacy iOS applications still using Objective-C without Swift interoperability
Simple apps with minimal design requirements where a full design system is overkill

Pros & Cons

Pros

Type-Safe Design Tokens

Doric uses Swift's type system to enforce consistency in typography and colors, reducing runtime errors and improving code reliability, as highlighted in its protocol-oriented APIs.

Scalable Atomic Design

Inspired by atomic design principles, it treats UI elements as composable building blocks, promoting consistency and scalability across large iOS applications.

Comprehensive Style Management

Includes tools for typography, colors, icons, spacing, gradients, and shadows, providing a full suite for implementing and debugging design systems.

Flexible Integration Options

Components can be used independently or mixed with third-party frameworks, such as using spacing with other libraries, offering adaptability in existing projects.

Cons

No Pre-built UI Components

Focuses on design foundations like tokens and styles, so developers must create or source UI components separately, increasing initial setup time and effort.

Protocol-Oriented Complexity

Requires familiarity with advanced Swift concepts like protocols and generics, which can be a barrier for developers less experienced with these patterns.

Incomplete Feature Set

The roadmap shows features like enhanced debugging tools and trait-based layouts are still in progress, limiting immediate functionality and requiring patience for updates.

Frequently Asked Questions

Related Projects

SkeletonView

☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting

Stars12,886

Forks1,125

Last commit1 month ago

Material

A UI/UX framework for creating beautiful applications.

Stars12,005

Forks1,257

Last commit4 years ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,706

Forks1,158

Last commit4 months ago

Macaw

Powerful and easy-to-use vector graphics Swift library with SVG support

Stars6,046

Forks569

Last commit2 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub