DFly7/integration-swift
.agents/skills/posthog-integration-swift/SKILL.md
PostHog integration for Swift iOS and macOS applications
tools
Updated Apr 17, 2026
$ install --global
skillsauthnpx skillsauth add DFly7/iOS-FastAPI-Supabase-AI integration-swiftInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 9:26 AM19.6s8 files scanned
SKILL.md
- name:
- integration-swift
- description:
- PostHog integration for Swift iOS and macOS applications
- author:
- PostHog
- version:
- 1.9.4
PostHog integration for Swift (iOS/macOS)
This skill helps you add PostHog analytics to Swift (iOS/macOS) applications.
Workflow
Follow these steps in order to complete the integration:
basic-integration-1.0-begin.md- PostHog Setup - Begin ← Start herebasic-integration-1.1-edit.md- PostHog Setup - Editbasic-integration-1.2-revise.md- PostHog Setup - Revisebasic-integration-1.3-conclude.md- PostHog Setup - Conclusion
Reference files
references/EXAMPLE.md- Swift (iOS/macOS) example project codereferences/ios.md- Ios - docsreferences/identify-users.md- Identify users - docsreferences/basic-integration-1.0-begin.md- PostHog setup - beginreferences/basic-integration-1.1-edit.md- PostHog setup - editreferences/basic-integration-1.2-revise.md- PostHog setup - revisereferences/basic-integration-1.3-conclude.md- PostHog setup - conclusion
The example project shows the target implementation pattern. Consult the documentation for API details.
Key principles
- Environment variables: Always use environment variables for PostHog keys. Never hardcode them.
- Minimal changes: Add PostHog code alongside existing integrations. Don't replace or restructure existing code.
- Match the example: Your implementation should follow the example project's patterns as closely as possible.
Framework guidelines
- Read configuration from environment variables via a
PostHogEnvenum with avaluecomputed property that callsProcessInfo.processInfo.environment[rawValue]andfatalErrors if missing — cases should beprojectToken = "POSTHOG_PROJECT_TOKEN"andhost = "POSTHOG_HOST", set in the Xcode scheme's Run environment variables - When adding SPM dependencies to project.pbxproj, create three distinct objects with unique UUIDs — a
PBXBuildFile(withproductRef), anXCSwiftPackageProductDependency(withpackageandproductName), and anXCRemoteSwiftPackageReference(withrepositoryURLandrequirement). The build file goes in the Frameworks phasefiles, the product dependency goes in the target'spackageProductDependencies, and the package reference goes in the project'spackageReferences. - Check the latest release version of posthog-ios at
https://github.com/PostHog/posthog-ios/releasesbefore setting theminimumVersionin the SPM package reference — do not hardcode a stale version - If the project uses App Sandbox (macOS), add
ENABLE_OUTGOING_NETWORK_CONNECTIONS = YESto the target's build settings so PostHog can reach its servers — do NOT disable the sandbox entirely
Identifying users
Identify users during login and signup events. Refer to the example code and documentation for the correct identify pattern for this framework. If both frontend and backend code exist, pass the client-side session and distinct ID using X-POSTHOG-DISTINCT-ID and X-POSTHOG-SESSION-ID headers to maintain correlation.
Error tracking
Add PostHog error tracking to relevant files, particularly around critical user flows and API boundaries.
Related Skills
DFly7/swift-concurrency
development
VerifiedTrustedCommunity
Resolve Swift concurrency compiler errors, adopt approachable concurrency (SE-0466), and write data-race-safe async code. Use when fixing Sendable conformance errors, actor isolation warnings, or strict concurrency diagnostics; when adopting default MainActor isolation, @concurrent, nonisolated(nonsending), or Task.immediate; when designing actor-based architectures, structured concurrency with TaskGroup, or background work offloading; or when migrating from @preconcurrency to full Swift 6 strict concurrency.
SKILL.mdUpdated Apr 17, 2026
DFly7/swift-codable
development
VerifiedTrustedCommunity
Implement Swift Codable models for JSON and property-list encoding and decoding with JSONDecoder, JSONEncoder, CodingKeys, and custom init(from:) or encode(to:). Use when parsing API responses, remapping keys, flattening nested JSON, handling date or data decoding strategies, decoding heterogeneous arrays, or integrating Codable with URLSession, SwiftData, or UserDefaults.
SKILL.mdUpdated Apr 17, 2026
DFly7/swift-charts
development
VerifiedTrustedCommunity
Implement, review, or improve data visualizations using Swift Charts. Use when building bar, line, area, point, pie, or donut charts; when adding chart selection, scrolling, or annotations; when plotting functions with vectorized BarPlot, LinePlot, AreaPlot, or PointPlot; when customizing axes, scales, legends, or foregroundStyle grouping; or when creating specialized visualizations like heat maps, Gantt charts, stacked/grouped bars, sparklines, or threshold lines.
SKILL.mdUpdated Apr 17, 2026
DFly7/supabase-postgres-best-practices
data-ai
VerifiedTrustedCommunity
Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
SKILL.mdUpdated Apr 17, 2026