How to install Gradients library in Xcode?

Gradients supports Swift Package Manager (recommended), CocoaPods, and Carthage. For SPM, add the package URL to your dependencies as shown in the README with .package(url: "https://github.com/Gradients/Gradients.git", .upToNextMajor(from: "0.3.1")).

Can I use Gradients with SwiftUI?

Gradients uses UIKit layer-based methods, so to use it with SwiftUI, you need to wrap it in a UIViewRepresentable. There's no native SwiftUI support provided in the library.

Gradients vs creating gradients manually in Swift?

Gradients saves time with 180+ pre-designed gradients and a simple API, whereas manual creation requires defining colors, locations, and directions yourself, offering more control but less convenience for common designs.

How to apply a gradient to a button in iOS using Gradients?

Use the layer-based method: button.layer.addSubLayer(Gradients.warmFlame.layer). Ensure the button's layer is set up correctly, as the library applies gradients via CALayer sublayers.

Is Gradients compatible with iOS 13 and above?

Yes, Gradients requires iOS 9.0+, so it's compatible with iOS 13 and newer versions, as stated in the README requirements.

How to create a custom gradient with specific colors in Gradients?

Use the linear method with colors array and locations, e.g., Gradients.linear(to: .degree(-225), colors: [0x231557, 0x44107A, 0xFF1361, 0xFFF800], locations: [0.0, 0.29, 0.67, 1.0]), as shown in the custom example.

Gradients or WebGradients for iOS apps?

Gradients is a Swift library inspired by WebGradients, tailored for iOS with easy integration via package managers. WebGradients is a web project; for iOS, Gradients provides a native solution with direct Swift API access.

Gradients — 180+ Swift Gradient Library

What is Gradients?

Gradients is a Swift library that provides a curated collection of over 180 ready-to-use gradients for iOS applications. It simplifies adding visually appealing gradient backgrounds and effects to UI components with minimal code, enhancing app aesthetics. The library includes predefined gradients like Warm Flame and Perfect Blue, supports directional control, and allows custom gradient creation.

Target Audience

iOS developers building apps with Swift who want to quickly implement high-quality gradient designs without manually configuring colors and locations. It's particularly useful for developers focused on UI/UX polish and visual appeal in their iOS applications.

Value Proposition

Developers choose Gradients for its extensive, curated collection of aesthetically pleasing gradients and its simple, elegant API that reduces implementation to a single line of code. It stands out by offering easy integration with Swift Package Manager, CocoaPods, and Carthage, plus inspiration from popular web gradient collections like WebGradients.

🌔 A curated collection of splendid 180+ gradients made in swift

Use Cases

Best For

Adding pre-designed gradient backgrounds to iOS app views with minimal coding effort.
Implementing gradient effects in UI components like buttons, headers, or cards using a simple enum-based API.
Creating custom linear gradients with specific colors, locations, and directional angles in Swift.
Enhancing the visual appeal of iOS apps with a library of over 180 curated gradients, such as Night Fade or Spring Warmth.
Integrating gradient support into iOS projects via Swift Package Manager, CocoaPods, or Carthage for easy dependency management.
Applying gradients in various directions (top, left, right, bottom) or custom angles using degrees for flexible design control.

Not Ideal For

Projects targeting platforms other than iOS, such as macOS, watchOS, or cross-platform frameworks like Flutter or React Native.
Apps requiring dynamic or animated gradients that change over time, as the library focuses on static gradient layers.
Developers using SwiftUI exclusively, since Gradients relies on UIKit layer-based methods without native SwiftUI support.
Teams needing complex gradient types like radial or conic gradients, as only linear gradients are supported.

Pros & Cons

Pros

Extensive Predefined Collection

Provides 180+ ready-to-use gradients like Warm Flame and Perfect Blue through an enum, saving design time and effort.

Simple Integration

Add gradients to views with a single line of code using layer-based methods, as demonstrated in the README example with view.layer.addSubLayer(Gradients.deepBlue.layer).

Flexible Direction Control

Supports applying gradients in various directions (top, left, right, bottom) or custom angles using degrees, offering design versatility.

Custom Gradient Creation

Allows building linear gradients with specific colors and locations for unique designs, shown in the custom example with Gradients.linear(to: .degree(-225), colors: [...], locations: [...]).

Cons

Limited to UIKit Layers

Uses CALayer-based methods, which may not integrate seamlessly with SwiftUI or newer iOS UI paradigms without additional wrapping code, limiting modern app development.

Static Gradient Support

Focuses on static gradients; lacks built-in support for animations or dynamic changes, restricting use in interactive or real-time visual effects.

Minimal Documentation

Relies on a basic README with code snippets, lacking comprehensive API documentation, tutorials, or examples for advanced scenarios like performance optimization.

Frequently Asked Questions

What is Gradients?

Target Audience

Value Proposition

Use Cases

Best For

Adding pre-designed gradient backgrounds to iOS app views with minimal coding effort.
Implementing gradient effects in UI components like buttons, headers, or cards using a simple enum-based API.
Creating custom linear gradients with specific colors, locations, and directional angles in Swift.
Enhancing the visual appeal of iOS apps with a library of over 180 curated gradients, such as Night Fade or Spring Warmth.
Integrating gradient support into iOS projects via Swift Package Manager, CocoaPods, or Carthage for easy dependency management.
Applying gradients in various directions (top, left, right, bottom) or custom angles using degrees for flexible design control.

Not Ideal For

Projects targeting platforms other than iOS, such as macOS, watchOS, or cross-platform frameworks like Flutter or React Native.
Apps requiring dynamic or animated gradients that change over time, as the library focuses on static gradient layers.
Developers using SwiftUI exclusively, since Gradients relies on UIKit layer-based methods without native SwiftUI support.
Teams needing complex gradient types like radial or conic gradients, as only linear gradients are supported.

Pros & Cons

Pros

Extensive Predefined Collection

Provides 180+ ready-to-use gradients like Warm Flame and Perfect Blue through an enum, saving design time and effort.

Simple Integration

Add gradients to views with a single line of code using layer-based methods, as demonstrated in the README example with view.layer.addSubLayer(Gradients.deepBlue.layer).

Flexible Direction Control

Supports applying gradients in various directions (top, left, right, bottom) or custom angles using degrees, offering design versatility.

Custom Gradient Creation

Allows building linear gradients with specific colors and locations for unique designs, shown in the custom example with Gradients.linear(to: .degree(-225), colors: [...], locations: [...]).

Cons

Limited to UIKit Layers

Uses CALayer-based methods, which may not integrate seamlessly with SwiftUI or newer iOS UI paradigms without additional wrapping code, limiting modern app development.

Static Gradient Support

Focuses on static gradients; lacks built-in support for animations or dynamic changes, restricting use in interactive or real-time visual effects.

Minimal Documentation

Relies on a basic README with code snippets, lacking comprehensive API documentation, tutorials, or examples for advanced scenarios like performance optimization.

Frequently Asked Questions

Gradients

What is Gradients?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

Gradients

What is Gradients?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?