SwiftShaders

A dependency-free Swift package for iOS 17+ and macOS 14+. Each effect is one view modifier, fill or transition on top of SwiftUI's own colorEffect, distortionEffect and layerEffect, so it works on any view. Every public argument is checked before it reaches the GPU, and the effects are verified by tests that render views and compare pixels.

Features

26 view modifiers, 3 fills and 5 transitions backed by 31 [[ stitchable ]] Metal functions

Argument checks: ranges are clamped, NaN switches an effect off, sample offsets are limited to the view's diagonal and gradient maps use at most 256 colors

Clean edges: effects that compare neighboring pixels read only inside the view, and color effects keep the antialiased alpha of text

ShaderTime (.animated, .animated(speed:), .fixed(_:)) for animated effects, which stop on their first frame when Reduce Motion is on

Tap-following ripples that leave the view's own gestures working

ShaderLibrary.swiftShaders to call the shader functions directly, and SwiftShaders.isMetalLibraryAvailable to check that the build tool compiled them

77 Swift Testing tests run on macOS and an iPhone simulator; a library test compares the compiled function names with the names the Swift code calls

DocC catalog with three articles and the ShaderGallery example app for iOS and macOS

Quickstart

swift

1import SwiftShaders
2import SwiftUI
3 
4struct ContentView: View {
5    var body: some View {
6        Image(systemName: "mountain.2.fill")
7            .font(.system(size: 96))
8            .foregroundStyle(.blue)
9            .padding(40)
10            .background(.blue.opacity(0.15), in: .rect(cornerRadius: 24))
11            .halftone(dotSize: 6, ink: .blue, paper: .white)
12    }
13}