zanwei/gradient-shimmer-swiftui

This project is a SwiftUI library that adds an animated, colorful highlight sweeping across a piece of text, similar to the shine effect you sometimes see on loading text in modern apps. It is a native Swift version of an existing web component called gradient shimmer, rebuilt to match the original as closely as the Apple platforms allow, and it does not depend on any outside packages. To use it, you add the package to your project and wrap your text in the provided view, passing in a font and a chosen gradient style, or building your own custom gradient by specifying your own set of color stops. The highlight band that sweeps across the text fades smoothly into your base text color rather than looking like a hard edged bar, using a color blending method called Oklab to keep the transition looking natural. The underlying text stays fully readable and selectable the whole time, since the shimmer is really just a moving mask drawn over normal text rather than a separate image. The animation itself is built using Apple's own drawing and timing tools rather than any third party animation library, and it is considerate about when it actually runs. It pauses automatically when the text scrolls off screen, while the user is actively scrolling, when the app is in the background, and it turns into fully static text if the user has reduced motion turned on in their accessibility settings. The library targets fairly recent versions of iOS and macOS, and ships with eight built in gradient presets with playful names like sunrise, peach, and twilight, plus a handful of settings you can adjust yourself, including sweep speed, band width, gradient angle, and the pause length between sweeps. The repository also includes a runnable demo app that mirrors the original web component's own showcase page, letting you try out the different presets before deciding which one to use in your own project. The project is released under the MIT license, crediting the original web component's creator for the underlying concept and visual design.