yerzong/TEMP-LEAGUE / .claude/skills/apple-design
apple-design
VerifiedCross-platform UI/UX design reviewer grounded in Apple Human Interface Guidelines principles. Use this skill to audit, review, critique, or improve any UI/UX design for mobile apps (iOS, Flutter, React Native) or desktop apps (macOS, Tauri, Electron). Triggers when the user mentions: design review, UI audit, HIG compliance, improving app design, design feedback, accessibility audit, or any request to check or improve a design against professional standards. Also use when the user uploads screenshots, mockups, wireframes, or design specs of a mobile or desktop app and wants feedback. Even if they just say "review my design" or "is this good UI", use this skill. Works for native and cross-platform frameworks including Flutter, Tauri, Electron, React Native, SwiftUI, and AppKit/UIKit.
references/hig/privacy.md
View on GitHub# Privacy
> Source: [https://developer.apple.com/design/human-interface-guidelines/privacy](https://developer.apple.com/design/human-interface-guidelines/privacy)
---
Privacy is paramount: it's critical to be transparent about the privacy-related data and resources you require and essential to protect the data people allow you to access.
People use their devices in very personal ways and they expect apps to help them preserve their privacy.
When you submit a new or updated app, you must provide details about your privacy practices and the privacy-relevant data you collect so the app store can display the information on your product page. People use the privacy details on your product page to make an informed decision before they download your app.
An app's product page helps people understand the app's privacy practices before they download it.
## Best practices
Request access only to data that you actually need. Asking for more data than a feature needs — or asking for data before a person shows interest in the feature — can make it hard for people to trust your app. Give people precise control over their data by making your permission requests as specific as possible.
Be transparent about how your app collects and uses people's data. People are less likely to be comfortable sharing data with your app if they don't understand exactly how you plan to use it. Always respect people's choices to use system features like privacy protection options, and be sure you understand your obligations with regard to app tracking.
Process data on the device where possible. In mobile, for example, you can take advantage of device capabilities and machine learning models to process the data right on the device, helping you avoid lengthy and potentially risky round trips to a remote server.
Adopt system-defined privacy protections and follow security best practices. For example, you can rely on system services to provide encryption and key management for sensitive data.
Requesting permissionHere are several examples of the things you must request permission to access:Personal data, including location, health, financial, contact, and other personally identifying informationUser-generated content like emails, messages, calendar data, contacts, gameplay information, music activity, and audio, video, and photo contentProtected resources like Bluetooth peripherals, home automation features, Wi-Fi connections, and local networksDevice capabilities like camera and microphoneTracking and analytics identifiersThe system provides a standard alert that lets people view each request you make. You supply copy that describes why your app needs access, and the system displays your description in the alert. People can also view the description — and update their choice — in Settings > Privacy.
Request permission only when your app clearly needs access to the data or resource. It's natural for people to be suspicious of a request for personal information or access to a device capability, especially if there's no obvious need for it. Ideally, wait to request permission until people actually use an app feature that requires access. For example, you can use the location button to give people a way to share their location after they indicate interest in a feature that needs that information.
Avoid requesting permission at launch unless the data or resource is required for your app to function. People are less likely to be bothered by a launch-time request when it's obvious why you're making it. For example, people understand that a navigation app needs access to their location before they can benefit from it.
Write copy that clearly describes how your app uses the ability, data, or resource you're requesting. The standard alert displays your copy (called a purpose string or usage description string) after your app name and before the buttons people use to grant or deny their permission. Aim for a brief, complete sentence that's straightforward, specific, and easy to understand. Use sentence case, avoid passive voice, and include a period at the end.
Example purpose stringNotesThe app records during the night to detect snoring sounds.
An active sentence that clearly describes how and why the app collects the data.
Microphone access is needed for a better experience.
A passive sentence that provides a vague, undefined justification.
Turn on microphone access.
An imperative sentence that doesn't provide any justification.
Here are several examples of the standard system alert: Example 1 Example 2 Example 3 Pre-alert screens, windows, or viewsIdeally, the current context helps people understand why you're requesting their permission. If it's essential to provide additional details, you can display a custom screen or window before the system alert appears. The following guidelines apply to custom views that display before system alerts that request permission to access protected data and resources, including camera, microphone, location, contact, calendar, and tracking.
Include only one button and make it clear that it opens the system alert. People can feel manipulated when a custom screen or window also includes a button that doesn't open the alert because the experience diverts them from making their choice. Another type of manipulation is using a term like "Allow" to title the custom screen's button. If the custom button seems similar in meaning and visual weight to the allow button in the alert, people can be more likely to choose the alert's allow button without meaning to. Use a term like "Continue" or "Next" to title the single button in your custom screen or window, clarifying that its action is to open the system alert.
Don't include additional actions in your custom screen or window. For example, don't provide a way for people to leave the screen or window without viewing the system alert — like offering an option to close or cancel.
Don't include an option to cancel.
Don't include an option to close the view.
Tracking requestsApp tracking is a sensitive issue. In some cases, it might make sense to display a custom screen or window that describes the benefits of tracking. If you want to perform app tracking as soon as people launch your app, you must display the system-provided alert before you collect any tracking data.
Never precede the system-provided alert with a custom screen or window that could confuse or mislead people. People sometimes tap quickly to dismiss alerts without reading them. A custom messaging screen, window, or view that takes advantage of such behaviors to influence choices will lead to rejection by app store review.
There are several prohibited custom-screen designs that will cause rejection. Some examples are offering incentives, displaying a screen or window that looks like a request, displaying an image of the alert, and annotating the screen behind the alert. Don't offer incentives for granting the request. You can't offer people compensation for granting their permission, and you can't withhold functionality or content or make your app unusable until people allow you to track them.
Don't display a custom screen that mirrors the functionality of the system alert. In particular, don't create a button title that uses "Allow" or similar terms, because people don't allow anything in a pre-alert screen.
Don't show an image of the standard alert and modify it in any way.
Don't add a visual cue that draws people's attention to the system alert's Allow buttons.
Location buttonIn mobile platforms, the system provides a button so people can grant your app temporary authorization to access their location at the moment a task needs it. A location button's appearance can vary to match your app's UI and it always communicates the action of location sharing in a way that's instantly recognizable.
The first time people open your app and tap a location button, the system displays a standard alert. The alert helps people understand how using the button limits your app's access to their location, and reminds them of the location indicator that appears when sharing starts.
After people confirm their understanding of the button's action, simply tapping the location button gives your app one-time permission to access their location. Although each one-time authorization expires when people stop using your app, they don't need to reconfirm their understanding of the button's behavior.
NoteIf your app has no authorization status, tapping the location button has the same effect as when a person chooses Allow Once in the standard alert. If people previously chose While Using the App, tapping the location button doesn't change your app's status.
Consider using the location button to give people a lightweight way to share their location for specific app features. For example, your app might help people attach their location to a message or post, find a store, or identify a building, plant, or animal they've encountered in their location. If you know that people often grant your app Allow Once permission, consider using the location button to help them benefit from sharing their location without having to repeatedly interact with the alert.
Consider customizing the location button to harmonize with your UI. Specifically, you can:Choose the system-provided title that works best with your feature, such as "Current Location" or "Share My Current Location."Choose the filled or outlined location glyph.
Select a background color and a color for the title and glyph.
Adjust the button's corner radius.
To help people recognize and trust location buttons, you can't customize the button's other visual attributes. The system also ensures a location button remains legible by warning you about problems like low-contrast color combinations or too much translucency. In addition to fixing such problems, you're responsible for making sure the text fits in the button — for example, button text needs to fit without truncation at all accessibility text sizes and when translated into other languages.
ImportantIf the system identifies consistent problems with your customized location button, it won't give your app access to the device location when people tap it. Although such a button can perform other app-specific actions, people may lose trust in your app if your location button doesn't work as they expect.
Protecting dataProtecting people's information is paramount. Give people confidence in your app's security and help preserve their privacy by taking advantage of system-provided security technologies when you need to store information locally, authorize people for specific operations, and transport information across a network.
Here are some high-level guidelines.
Avoid relying solely on passwords for authentication. Where possible, use passkeys to replace passwords. If you need to continue using passwords for authentication, augment security by requiring two-factor authentication. To further protect access to apps that people keep logged in on their device, use biometric identification like Face ID or Touch ID.
Store sensitive information in a secure keychain. A keychain provides a secure, predictable user experience when handling someone's private information.
Never store passwords or other secure content in plain-text files. Even if you restrict access using file permissions, sensitive information is much safer in an encrypted keychain.
Avoid inventing custom authentication schemes. If your app requires authentication, prefer system-provided features like passkeys, Sign in with Apple, or Password AutoFill.
## Platform considerations
No additional considerations for mobile platforms.
## Desktop
Sign your app with a valid Developer ID. If you choose to distribute your app outside the store, signing your app with Developer ID identifies you as a developer and confirms that your app is safe to use.
Protect people's data with app sandboxing. Sandboxing provides your app with access to system resources and user data while protecting it from malware.
Avoid making assumptions about who is signed in. Because of fast user switching, multiple people may be active on the same system.
## Related
Entering dataOnboarding
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |