generators-usage-insights

What problem does it solve?

Many apps lack a lightweight, privacy-preserving way to show users their activity, trends, and milestones without sending event data to a backend. This Skill provides a local-first system to record user events, compute meaningful insights, and surface them in an accessible dashboard so users can understand and celebrate their usage.

Core Features & Use Cases

• On-device event recording using SwiftData models for privacy-first analytics and optional batching for performance.
• Computation engine (InsightCalculator) that derives totals, streaks, most active periods, top categories, and duration summaries with calendar-aware period math.
• SwiftUI dashboard & visualizations including insight cards, period pickers, Swift Charts integration, and an optional shareable recap image for weekly/monthly/yearly summaries.
• Use Case: Add a "My Insights" screen that shows a weekly recap, streaks, and top categories computed locally from recorded UsageEvent objects.

Quick Start

Generate a weekly, on-device insights dashboard using SwiftData events, SwiftUI views, and the provided templates to render cards and a shareable recap.