# 2566 13 Onboarding And Permission UI Blueprints 05a1297d

> 13 Onboarding and Permission UI Blueprints

- Skill: `tools-only/2566-13-onboarding-and-permission-ui-blueprints-05a1297d` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/2566-13-onboarding-and-permission-ui-blueprints-05a1297d`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/2566-13-onboarding-and-permission-ui-blueprints-05a1297d/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/2566-13-onboarding-and-permission-ui-blueprints-05a1297d

---

# 13 Onboarding and Permission UI Blueprints

## Purpose
Define a resilient onboarding sequence for Screen Time authorization, app selection, and schedule setup.

## Canonical API Surface
- `AuthorizationCenter.authorizationStatus`
- `requestAuthorization(for:)`
- `FamilyActivityPicker`

## Implementation Pattern
1. Explain why permission is needed before prompting.
2. Request authorization with clear state feedback.
3. Gate picker until authorization is approved.
4. Require at least one selected token set before completion.
5. Add explicit deny/revoke remediation steps.
6. Persist onboarding-complete only after policy prerequisites are met.

## Failure Modes
- Silent authorization errors (`try?` with no UX fallback).
- Allowing onboarding completion without valid selection.
- Not handling post-approval revocation.

## Validation Checklist
- [ ] UI differentiates `.notDetermined` vs `.denied` states.
- [ ] Picker opens only when authorized.
- [ ] Selection summary updates immediately after picker change.
- [ ] Recovery copy includes Settings navigation path.

## Sources
- `../rundowns/10-project-alpha-rundown.md`
- `../rundowns/11-project-beta-rundown.md`
- `../evidence/01-familycontrols-sdk-signatures.md`
- https://developer.apple.com/documentation/familycontrols/authorizationcenter
- https://developer.apple.com/documentation/familycontrols/familyactivitypicker

## Confidence Notes
- Permission state model is `canonical + sdk-backed`.
- Onboarding flow sequence is `project-observed` blueprint guidance.