Skip to content

luxardolabs/LuxAnalytics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LuxAnalytics

A privacy-first, high-performance analytics SDK for iOS 18+ built with Swift 6. Zero compilation warnings with full strict concurrency compliance.

✨ Key Features

  • 🔒 Privacy-First - Automatic PII filtering, encrypted storage
  • 100% Async/Await - Modern Swift concurrency throughout
  • 🎯 Swift 6 Compliant - Full actor isolation and data race safety
  • 📦 Smart Batching - Automatic event batching with offline support
  • 🔐 Simple Setup - Single DSN configuration string
  • 🛡️ Production Ready - Circuit breaker, retry logic, comprehensive error handling

🚀 Quick Start

Installation

dependencies: [
    .package(url: "https://github.com/luxardolabs/LuxAnalytics", from: "1.0.0")
]

Setup

import LuxAnalytics

@main
struct MyApp: App {
    init() {
        Task {
            try await LuxAnalytics.quickStart(
                dsn: "https://your-public-id@analytics.example.com/api/v1/events/your-project-id"
            )
        }
    }
    
    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

Track Events

let analytics = await LuxAnalytics.shared

// Track events
try await analytics.track("user_signup", metadata: [
    "method": "email",
    "source": "app"
])

// Set user context
await analytics.setUser("user-123")
await analytics.setSession("session-456")

📋 Requirements

  • iOS 18.0+
  • Swift 6.0+
  • Xcode 16.0+

📚 Documentation

Topic Description
📖 Complete Guide Comprehensive documentation and tutorials
Quick Start Get running in under 5 minutes
🔧 Configuration Detailed setup and customization options
🔒 Privacy & Security Privacy-first architecture and data protection
🚀 API Reference Complete API documentation
🐛 Troubleshooting Common issues and solutions

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📞 Support

📄 License

MIT License - see LICENSE for details.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages