Tamatoa 🦀✨

A Swift Package for adding beautiful, interactive, shiny card effects to any SwiftUI view. Tamatoa uses CoreMotion to create a real-time glossy highlight and 3D tilt driven by device motion, delivering a premium, tactile visual experience for your app's UI.

Credit

Inspired by maustinstar/shiny and a certain flamboyant, shiny crab 🦀✨.

---

Features

• ✨ Shiny Card: Add a reflective, animated highlight and realistic 3D tilt to any SwiftUI view.
• 📲 Motion-driven: Uses CoreMotion to respond to pitch, yaw, and roll of the device.
• 🎛️ Customizable:
  • Gradient highlight surface
  • Toggle 3D tilt effect
  • Control effect dampening on each axis
  • Fit or fill highlight surface
• 🧩 Drop-in Modifier: Just use .shinyCard() on any SwiftUI view.

---

Requirements

• iOS 15.0+
• Swift 5.9+
• SwiftUI
• CoreMotion

---

Usage

Add Tamatoa to your project as a Swift Package:

1. In Xcode, go to File > Add Packages…
2. Enter this repository URL:

https://github.com/thisIsTheFoxe/Tamatoa

3. import Tamatoa in your SwiftUI view
4. Ensure you call MotionManager.startDeviceMotionUpdates() in your app before you want to use the framework
5. Use the .shinyCard() on any SwiftUI view.