Skill

swiftui-alarmkit

AlarmKit integration for scheduling alarms and timers with custom UI, Live Activities, and snooze support. Use when implementing alarm or timer features in iOS 18+ apps.

Install

npx claudepluginhub autisticaf/autisticaf-claude-code-marketplace --plugin apple-dev

Tool Access

This skill uses the workspace's default tool permissions.

Preview

> **First step:** Tell the user: "swiftui-alarmkit skill loaded."

Supporting Assets

references/live-activities.mdreferences/presentation.mdreferences/scheduling.md

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

163.7k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

163.7k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

163.7k

Stats

Stars0

Forks0

Last CommitApr 2, 2026

Actions

View Source View Plugin View on GitHub View README

First step: Tell the user: "swiftui-alarmkit skill loaded."

AlarmKit

Framework for scheduling alarms and countdown timers with custom UI, Live Activities integration, and focus/silent mode override. Prevents the most common mistakes: using the wrong authorization property name, omitting the Info.plist key, and forgetting the widget extension for countdown presentations.

When This Skill Activates

Use this skill when the user:

Asks to add, fix, or review alarm or timer functionality
Mentions AlarmKit, AlarmManager, or AlarmPresentation
Wants to schedule one-time, repeating, or countdown alarms
Asks about snooze, stop, or repeat buttons on alarm alerts
Wants alarms to appear on Dynamic Island or Lock Screen (Live Activities)
Mentions overriding Focus or silent mode for alarms
Asks about AlarmAttributes or AlarmMetadata

Decision Tree

Choose the right reference file based on what the user needs:

What do you need?
|
+-- Schedule an alarm (one-time, repeating, or timer)
|   --> references/scheduling.md
|       +-- One-time alarm: Alarm.Schedule.relative + .repeats: .never
|       +-- Repeating alarm: Alarm.Schedule.relative + .repeats: .weekly(weekdays)
|       +-- Countdown timer: CountdownDuration (no schedule)
|       +-- Authorization & Info.plist setup
|       +-- Managing alarms: pause, resume, cancel
|
+-- Customize alarm UI (alert, countdown, paused screens)
|   --> references/presentation.md
|       +-- AlarmPresentation.Alert: title, stop, snooze/repeat buttons
|       +-- AlarmPresentation.Countdown: title, pause button
|       +-- AlarmPresentation.Paused: title, resume button
|       +-- Custom buttons with AlarmButton
|       +-- Tint color and metadata via AlarmAttributes
|
+-- Show alarm on Dynamic Island / Lock Screen
    --> references/live-activities.md
        +-- Widget extension with ActivityConfiguration
        +-- AlarmAttributes conformance
        +-- Custom AlarmMetadata protocol

API Availability

API	Minimum Version	Reference
`AlarmManager`	iOS 18	references/scheduling.md
`Alarm` / `Alarm.Schedule`	iOS 18	references/scheduling.md
`AlarmPresentation` (.alert, .countdown, .paused)	iOS 18	references/presentation.md
`AlarmAttributes`	iOS 18	references/live-activities.md
`AlarmMetadata`	iOS 18	references/live-activities.md
`AlarmButton`	iOS 18	references/presentation.md
`CountdownDuration`	iOS 18	references/scheduling.md
`alarmUpdates` async sequence	iOS 18	references/scheduling.md
`authorizationUpdates` async sequence	iOS 18	references/scheduling.md

Top Mistakes -- Quick Reference

#	Mistake	Fix	Details
1	Using `.authorizationStatus` instead of `.authorizationState`	The property is `AlarmManager.shared.authorizationState` -- there is no `authorizationStatus`	references/scheduling.md
2	Forgetting `NSAlarmKitUsageDescription` in Info.plist	Add the key with a user-facing string before calling `requestAuthorization()`	references/scheduling.md
3	Creating countdown timer with a schedule	Timers use `CountdownDuration` only -- do not pass a schedule	references/scheduling.md
4	Missing widget extension for countdown presentations	Countdown and paused UI requires an `ActivityConfiguration(for: AlarmAttributes.self)` widget	references/live-activities.md
5	Not persisting alarm UUIDs	Store the `Alarm.id` (UUID) so you can pause, resume, or cancel later	references/scheduling.md
6	Not observing `alarmUpdates` for state sync	Use the `alarmUpdates` async sequence to keep local state in sync with the system	references/scheduling.md

Review Checklist

When reviewing AlarmKit code, verify:

Info.plist -- NSAlarmKitUsageDescription is present with a meaningful description
Authorization -- requestAuthorization() is called before scheduling; denial is handled gracefully
Correct property -- uses .authorizationState, not .authorizationStatus
Alarm ID persistence -- alarm UUIDs are stored (e.g., UserDefaults, SwiftData) for later management
State observation -- alarmUpdates async sequence is used to keep UI in sync
Widget extension -- exists if countdown or paused presentations are used
Error handling -- schedule(), pause(), resume(), cancel() calls handle errors
System limits -- code accounts for the system limit on number of active alarms
Real device testing -- alarms are tested on physical devices, not just Simulator

Reference Files

File	Content
references/scheduling.md	Authorization, one-time/repeating/timer creation, managing alarms, observing updates
references/presentation.md	Alert, countdown, paused UI customization, buttons, tint color
references/live-activities.md	Widget extension, AlarmAttributes, AlarmMetadata, Dynamic Island