⌚ WatchOS Quick Start

1. 1
   Get API Key
2. 2
   Install SDK
3. 3
   Initialize

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

import SwiftUI
import RotationKit

struct MyWatchApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

struct ContentView: View {
    // Initialize RotationKit (paste your API key here)
    @StateObject private var rotationEngine = RotationEngine(
        configuration: RotationConfiguration(
            apiKey: "rk_dev_watchos_YOUR_KEY_HERE", // ← Your API key
            enableQuickToggle: true
        )
    )

    var body: some View {
        RotationHUD(rotationEngine: rotationEngine) {
            // Your app content here - stays upright automatically!
            MyAppScreen()
        }
    }
}

struct MyAppScreen: View {
    var body: some View {
        VStack {
            Text("My Fitness App")
                .font(.headline)
            Text("Always Readable!")
                .font(.body)
        }
        .foregroundColor(.white)
    }
}

View Your Analytics

1. Go to rotationkit.com/portal
2. See real-time usage:
   • Total sessions
   • Rotation events
   • Mode preferences
   • Device distribution

User Controls

Three Rotation Modes:

• Auto-Rotation 🌐: Gravity-based intelligent rotation (default)
• Manual Rotation 👑: Precision control with Digital Crown
• Standard 🔒: Fixed orientation, no rotation

Mode Toggle:

• Long press the watch face → Cycles through modes
• Digital Crown in Manual mode → Rotate interface
• Visual indicators show current mode and angle

Activity-Based Presets

Choose the best config for your app type:

// Fitness apps (dynamic sports)
RotationEngine(configuration: .forActivity(.fitness))

// Navigation apps (maps, directions)
RotationEngine(configuration: .forActivity(.navigation))

// Reading apps (gentle rotation)
RotationEngine(configuration: .forActivity(.reading))

Add Positioned Widgets

Make your data always readable with RotationKit's widget system:

RotationHUD(rotationEngine: rotationEngine) {
    WidgetBuilder.mixedWidgets([
        // Time at top
        AnyHUDWidget(TextWidget(
            data: "27:32",
            position: 0
        )),

        // Heart rate at 3 o'clock
        AnyHUDWidget(IconTextWidget(
            data: IconTextWidget.IconTextData(
                iconName: "heart.fill",
                text: "142 bpm",
                iconColor: .red
            ),
            position: 2
        )),

        // Speed at bottom
        AnyHUDWidget(SpeedWidget(
            data: SpeedWidget.SpeedData(speed: 7.2, unit: .mph),
            position: 4
        ))
    ], rotationEngine: rotationEngine)
}

Common Questions

Do I need an API key?

Yes - API keys enable:

• Usage analytics in your portal
• License validation for production
• Telemetry and error tracking

Development keys are free and never expire.

What data is collected?

Only anonymous usage analytics:

• Session duration
• Rotation mode changes
• Rotation angle changes
• Device model and watchOS version

No personal data is ever collected (no names, emails, health data).

How does auto-rotation work?

RotationKit uses patented sensor fusion technology:

• Reads device gravity sensor
• Calculates optimal interface orientation
• Smoothly rotates to keep content upright
• Works at any wrist angle, any activity

How do I upgrade to production?

1. Get a production license at rotationkit.com/pricing
2. Create a new Production API key in the portal
3. Replace your dev key with the production key
4. Submit to App Store!

Support

Need help? We're here for you:

• 📧 Email: support@rotationkit.com
• 💬 Discord: discord.gg/rotationkit
• 📚 Docs: Full Documentation