balochcodes/pulseglowbutton

An eye-catching, high-conversion call-to-action button for SwiftUI featuring an animated radiant breathing glow aura, expanding concentric sonar ripple rings, tactile press physics, and seamless async loading state transitions.

✨ Features

🌟 Radiant Ambient Glow: Organic breathing light aura radiating softly around the button container with configurable blur radiuses and bloom colors.
📡 Concentric Sonar Ripples: Pulsating wave rings expanding outwards with progressive opacity fade.
📳 Tactile Press Physics: Smooth spring compression scaling on finger touch coupled with native iOS haptic feedback (UIImpactFeedbackGenerator).
⏳ Integrated Loading Spinner: Instant switch between normal CTA content and a progress indicator with state preservation (isLoading: true).
🎨 Gradient & Solid Styles: Supports multi-stop linear gradients, solid fills, custom corner radii, and padding via PulseGlowStyle.
⚡ Zero External Dependencies: 100% native SwiftUI with zero third-party bloat.

📦 Installation

In Xcode (Recommended)

Open your project in Xcode and navigate to File ➔ Add Package Dependencies...
In the search field, paste the repository URL:

``text https://github.com/BalochCodes/PulseGlowButton.git ``

Select Up to Next Major Version (1.0.0) and click Add Package.

In `Package.swift`

Add PulseGlowButton to your dependencies:

dependencies: [
    .package(url: "https://github.com/BalochCodes/PulseGlowButton.git", from: "1.0.0")
]

Import the package in your SwiftUI files:

import SwiftUI
import PulseGlowButton

🚀 Usage Examples

1. High-Conversion "Claim Reward" Hero CTA

PulseGlowButton(
    title: "Claim Daily Reward",
    systemImage: "star.fill",
    style: PulseGlowStyle(
        glowColor: Color(red: 0.54, green: 0.36, blue: 0.96),
        maxGlowRadius: 24,
        backgroundColor: Color(red: 0.49, green: 0.23, blue: 0.93),
        cornerRadius: 20
    ),
    action: {
        print("Reward claimed!")
    }
)

2. Live Broadcast / Emergency Beacon with Gradient

PulseGlowButton(
    title: "GO LIVE NOW",
    systemImage: "dot.radiowaves.left.and.right",
    style: PulseGlowStyle(
        glowColor: Color.red,
        rippleColor: Color(red: 1.0, green: 0.4, blue: 0.4),
        rippleCount: 3,
        rippleMaxScale: 1.5,
        gradient: LinearGradient(
            colors: [Color.red, Color(red: 0.8, green: 0.1, blue: 0.1)],
            startPoint: .topLeading,
            endPoint: .bottomTrailing
        ),
        cornerRadius: 24,
        pulseDuration: 1.4
    ),
    action: {
        print("Live streaming initiated!")
    }
)

3. Asynchronous Checkout Button with Loading Spinner

struct CheckoutButtonView: View {
    @State private var isProcessing = false

    var body: some View {
        PulseGlowButton(
            title: "Complete Checkout ($49.00)",
            systemImage: "lock.fill",
            style: PulseGlowStyle(
                glowColor: Color.green,
                backgroundColor: Color(red: 0.05, green: 0.65, blue: 0.4),
                cornerRadius: 16
            ),
            isLoading: isProcessing,
            action: {
                isProcessing = true
                DispatchQueue.main.asyncAfter(deadline: .now() + 2) {
                    isProcessing = false
                }
            }
        )
    }
}

🛠️ API Reference

`PulseGlowButton`

`PulseGlowStyle`

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Created by Shahzain Baloch.

Package Metadata

Repository: balochcodes/pulseglowbutton

Default branch: main

README: README.md