🌈 Beautiful

Beautiful is a collection of carefully crafted, reusable SwiftUI components focused on delightful interactions and clean visual presentation — built with kids, creatives, and story-first apps in mind.

Designed to be portable, expressive, and lightweight.

✨ Features

CharacterCard – a visual representation for emoji or image-based characters
Pressable – a flexible gesture wrapper for native-feeling press feedback
.pressable() – a SwiftUI modifier to apply press behavior to any view

📦 Installation

Add Beautiful via Swift Package Manager:

dependencies: [
    .package(url: "https://github.com/michaelborgmann/Beautiful.git", from: "0.1.0")
]

Or in Xcode:

File → Add Packages
Enter the repo URL
Choose Beautiful

🚀 Components

🧸 CharacterCard

CharacterCard(
    visual: .emoji("🦄"),
    placeholder: "👤",
    background: .white,
    aspectRatio: 1,
    cornerRadius: 24,
    shadowRadius: 3,
    padding: 16
)

Supports:

Emoji or image visual
Custom aspect ratios (square, 4:3, etc.)
Rounded corners and shadows
Placeholder fallback

👆 Pressable & .pressable()

Pressable(action: {
    print("Tapped!")
}) {
    CharacterCard(visual: .emoji("🦊"))
}

Or:

Text("Tap Me")
    .padding()
    .background(Color.white)
    .cornerRadius(12)
    .pressable {
        print("Tapped!")
    }

Adds smooth press animation and native-like release behavior.

🧪 Requirements

Swift 5.10+
iOS 17+
SwiftUI

🗺️ Roadmap

Add .selected overlay support for CharacterCard
Optional haptic feedback for Pressable
Expand visuals (e.g. imageURL, SF Symbols)
Add web/Android equivalents later via portable design system

👤 About

Created with care by Michael Borgmann for joyful, expressive apps — like WonderTales.

📄 License

MIT License. See LICENSE for details.

Beautiful

main