Track. Debug. Distribute. AppAmbit: track, debug, and distribute—one SDK, one dashboard.

The AppAmbit iOS SDK adds lightweight analytics, event tracking, logs, crash reporting, and release distribution hooks to your iOS apps. It is designed for simple setup, low overhead, and production-ready defaults.

Full product docs live here: docs.appambit.com

• Features
• Requirements
• Install
• Quickstart
• Usage
• Release Distribution
• Privacy and Data
• Troubleshooting
• Contributing
• Versioning
• Security
• License

• Session analytics with automatic lifecycle tracking
• Event tracking with rich properties
• Structured logs with levels and tags
• Crash capture with stack traces and threads
• Network-safe batching, retry, and offline queue
• Configurable endpoints for staging and production
• Small footprint, modern Swift API

• iOS 13.0 or newer
• Xcode 15 or newer
• Swift 5.9 or newer

• Add the repository URL in Xcode under File → Add Packages…
• Select the latest version and attach it to your app target

• Add pod 'AppAmbitSdk' to your Podfile
• Run pod install
• Open the generated .xcworkspace

• Configure the SDK at app launch with your API key and base URL
• Verify session data flows into your AppAmbit dashboard
• Begin tracking events, logs, and crashes

• Identify Users: attach traits and metadata to your sessions
• Track Events: send structured events with custom properties
• Logs: add structured log messages for debugging
• Crash Reporting: uncaught crashes are automatically captured

• Optionally enable in-app build update checks for tester workflows
• Safe to omit for production apps that only use telemetry

• The SDK batches and transmits data efficiently
• You control what is sent — avoid secrets or sensitive PII
• Supports compliance with Apple platform policies

For details, see the docs: docs.appambit.com

• No data in dashboard → check API key, endpoint, and network access
• CocoaPods errors → run pod repo update, then pod install
• SPM not resolving → confirm repo URL and tagged release version
• Crash not appearing → crashes are sent on next launch

We welcome issues and pull requests.

• Fork the repo
• Create a feature branch
• Add tests where applicable
• Open a PR with a clear summary

Please follow Swift API design guidelines and document public APIs.

Semantic Versioning (MAJOR.MINOR.PATCH) is used.

• Breaking changes → major
• New features → minor
• Fixes → patch

If you find a security issue, please contact us at [email protected] rather than opening a public issue.

Open source under the terms described in the LICENSE file.

• Docs: docs.appambit.com
• Dashboard: AppAmbit workspace link
• Examples: Sample swift test app AppAmbitTestApp include in repo. Objective-c test app coming soon.