SkeletonShimmerKit

Beautiful, lightweight, and fully customizable skeleton loading for SwiftUI.

Features

• ✨ Animated shimmer placeholders
• 🎨 Shape-based SkeletonView
• 🧩 .skeleton() modifier for any SwiftUI view
• 🌍 Environment-driven configuration
• ↔️ Automatic RTL/LTR support
• ♿ Respects Reduce Motion
• 🧱 Immutable fluent configuration
• 🍎 Pure SwiftUI

Requirements

• iOS 16+
• SwiftUI

Installation

Swift Package Manager

Add the package URL in Xcode.

Quick Start

SkeletonView(shape: RoundedRectangle(cornerRadius: 12))

Text("Username")
    .skeleton(isRedacted: true)

Configuration

let configuration = SkeletonConfiguration.default
    .duration(1.4)
    .rotation(8)
    .tint(.gray.opacity(0.25))
    .highlight(.white.opacity(0.9))
    .widthFactor(0.45)
    .blendMode(.softLight)
    .direction(.automatic)

Global Configuration

ContentView()
    .skeletonConfiguration(configuration)

API Reference

SkeletonView

Displays a standalone skeleton placeholder for any SwiftUI Shape.

View.skeleton(...)

Applies a skeleton placeholder to existing views using SwiftUI redaction.

SkeletonConfiguration

Immutable configuration object with fluent builder methods.

SkeletonDirection

• automatic
• leftToRight
• rightToLeft

Accessibility

• Reduce Motion supported
• RTL supported
• VoiceOver placeholder hidden while loading

Best Practices

• Configure once via environment.
• Override locally only when necessary.
• Keep shimmer subtle.

License

MIT