Skip to main content
GlassText is a SwiftUI library that creates stunning glass morphism text effects using the latest SwiftUI glass effect API. This guide will walk you through the fundamental usage patterns.

​
Installation

Add GlassText to your project using Swift Package Manager:
  1. In Xcode, go to File → Add Package Dependencies
  2. Enter the repository URL: https://github.com/ailtonvivaz/GlassText
  3. Select the version you want to use
  4. Add to your target
GlassText requires iOS 26.0+ / macOS 26.0+ / tvOS 26.0+ / watchOS 26.0+ and Swift 6.2+

​
Your first glass text

The simplest way to use GlassText is to initialize it with a string: 
import SwiftUI
import GlassText

struct ContentView: View {
    var body: some View {
        GlassText("Hello, World!", glass: .regular)
            .font(.largeTitle)
            .fontWeight(.bold)
            .frame(maxWidth: .infinity, maxHeight: .infinity)
            .background(
                AsyncImage(url: URL(string: "your-image-url")) { image in
                    image
                        .resizable()
                        .scaledToFill()
                } placeholder: {
                    LinearGradient(
                        gradient: Gradient(colors: [.blue, .purple]),
                        startPoint: .topLeading,
                        endPoint: .bottomTrailing
                    )
                }
            )
    }
}

​
Initializers

GlassText provides two initializers to suit different needs: 
public init(
    _ text: String,
    glass: Glass = .clear
)

​
Parameters

  • text: The text to display (String or LocalizedStringResource)
  • glass: The glass effect to apply (default: .clear)

​
Background best practices

For optimal glass morphism effects, use GlassText over colorful or textured backgrounds:
Glass morphism effects work best with dynamic backgrounds like images or gradients. Static solid colors won’t showcase the glass effect effectively.
ZStack {
    // Background
    AsyncImage(url: URL(string: "your-background-image-url")) { image in
        image
            .resizable()
            .scaledToFill()
            .ignoresSafeArea()
    } placeholder: {
        LinearGradient(
            gradient: Gradient(colors: [.blue, .purple]),
            startPoint: .topLeading,
            endPoint: .bottomTrailing
        )
    }
    
    // Glass text
    GlassText("Glass Effect", glass: .regular.tint(.white))
        .font(.system(size: 64, weight: .bold, design: .rounded))
}

​
Multi-line text

GlassText automatically handles multi-line text with proper line height calculations using Core Text: 
GlassText("""
Multi-line
Glass Text
Effect
""", glass: .regular)
.font(.system(size: 36, weight: .semibold))
.fontDesign(.serif)
.multilineTextAlignment(.center)
GlassText uses Core Text for precise text rendering and measurements, ensuring accurate multi-line text layout across different font designs and weights.

​
Complete example

Here’s a full working example showcasing multiple glass text elements: 
import SwiftUI
import GlassText

struct GlassTextDemo: View {
    var body: some View {
        ScrollView {
            LazyVStack(spacing: 20) {
                GlassText("Glass 2048", glass: .regular)
                    .font(.system(size: 44))
                    .fontWeight(.heavy)
                    .fontDesign(.rounded)
                
                VStack(spacing: 15) {
                    GlassText("Light", glass: .regular.tint(.cyan))
                        .font(.system(size: 36).weight(.light))
                        .fontDesign(.rounded)
                    
                    GlassText("Bold", glass: .regular.tint(.orange))
                        .font(.system(size: 36).weight(.bold))
                        .fontDesign(.rounded)
                    
                    GlassText("Heavy", glass: .regular.tint(.purple))
                        .font(.system(size: 36).weight(.heavy))
                        .fontDesign(.rounded)
                }
            }
        }
        .frame(maxWidth: .infinity, maxHeight: .infinity)
        .background {
            AsyncImage(url: URL(string: "your-image-url")) { image in
                image
                    .resizable()
                    .scaledToFill()
                    .ignoresSafeArea()
            } placeholder: {
                Color.gray.opacity(0.2)
            }
        }
    }
}

​
Platform support

GlassText is cross-platform compatible:
  • iOS 26.0+
  • macOS 26.0+
  • tvOS 26.0+
  • watchOS 26.0+
visionOS is not supported due to platform-specific glass effect API limitations.

Build docs developers (and LLMs) love

Get started for freeTalk to us