Skip to content

yerzong/TEMP-LEAGUE / .claude/skills/apple-design

apple-design

Verified

Cross-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.

FileKindSize
README.mdmarkdown4.7 KB
SKILL.mdskill md12.2 KB
references/hig-lookup.mdmarkdown3.0 KB
references/hig/accessibility.mdmarkdown12.9 KB
references/hig/app-icons.mdmarkdown8.7 KB
references/hig/apple-pay.mdmarkdown23.8 KB
references/hig/apple-pencil-and-scribble.mdmarkdown12.3 KB
references/hig/augmented-reality.mdmarkdown19.1 KB
references/hig/branding.mdmarkdown2.9 KB
references/hig/charting-data.mdmarkdown5.9 KB
references/hig/collaboration-and-sharing.mdmarkdown4.8 KB
references/hig/color.mdmarkdown11.6 KB
references/hig/dark-mode.mdmarkdown6.7 KB
references/hig/drag-and-drop.mdmarkdown12.0 KB
references/hig/entering-data.mdmarkdown3.4 KB
references/hig/feedback.mdmarkdown3.2 KB
references/hig/file-management.mdmarkdown9.7 KB
references/hig/focus-and-selection.mdmarkdown6.2 KB
references/hig/game-controls.mdmarkdown9.1 KB
references/hig/generative-ai.mdmarkdown14.4 KB
references/hig/gestures.mdmarkdown6.0 KB
references/hig/going-full-screen.mdmarkdown4.3 KB
references/hig/icons.mdmarkdown9.9 KB
references/hig/images.mdmarkdown2.8 KB
references/hig/in-app-purchase.mdmarkdown14.7 KB
references/hig/inclusion.mdmarkdown12.8 KB
references/hig/keyboards.mdmarkdown14.9 KB
references/hig/launching.mdmarkdown3.4 KB
references/hig/layout.mdmarkdown15.3 KB
references/hig/liquid-glass.mdmarkdown8.4 KB
references/hig/live-viewing-apps.mdmarkdown6.2 KB
references/hig/loading.mdmarkdown2.6 KB
references/hig/machine-learning.mdmarkdown33.2 KB
references/hig/managing-accounts.mdmarkdown5.2 KB
references/hig/managing-notifications.mdmarkdown5.9 KB
references/hig/maps.mdmarkdown11.2 KB
references/hig/materials.mdmarkdown1.4 KB
references/hig/modality.mdmarkdown4.5 KB
references/hig/motion.mdmarkdown3.4 KB
references/hig/multitasking.mdmarkdown4.6 KB
references/hig/offering-help.mdmarkdown5.7 KB
references/hig/onboarding.mdmarkdown4.3 KB
references/hig/playing-audio.mdmarkdown7.0 KB
references/hig/playing-haptics.mdmarkdown9.8 KB
references/hig/playing-video.mdmarkdown8.4 KB
references/hig/pointing-devices.mdmarkdown18.8 KB
references/hig/printing.mdmarkdown3.1 KB
references/hig/privacy.mdmarkdown12.0 KB
references/hig/ratings-and-reviews.mdmarkdown2.9 KB
references/hig/right-to-left.mdmarkdown8.7 KB
references/hig/searching.mdmarkdown3.8 KB
references/hig/settings.mdmarkdown5.9 KB
references/hig/sf-symbols.mdmarkdown13.8 KB
references/hig/typography.mdmarkdown9.0 KB
references/hig/undo-and-redo.mdmarkdown3.8 KB
references/hig/writing.mdmarkdown8.1 KB

references/hig/icons.md

View on GitHub
# Icons

> Source: [https://developer.apple.com/design/human-interface-guidelines/icons](https://developer.apple.com/design/human-interface-guidelines/icons)

---

An effective icon is a graphic asset that expresses a single concept in ways people instantly understand.

Apps and games use a variety of simple icons to help people understand the items, actions, and modes they can choose. Unlike app icons, which can use rich visual details like shading, texturing, and highlighting to evoke the app's personality, an interface icon typically uses streamlined shapes and touches of color to communicate a straightforward idea.

You can design interface icons — also called glyphs — or you can choose symbols from the system icon set, using them as-is or customizing them to suit your needs. Both interface icons and symbols use black and clear colors to define their shapes; the system can apply other colors to the black areas in each image.

## Best practices

Create a recognizable, highly simplified design. Too many details can make an interface icon confusing or unreadable. Strive for a simple, universal design that most people will recognize quickly. In general, icons work best when they use familiar visual metaphors that are directly related to the actions they initiate or content they represent.

Maintain visual consistency across all interface icons in your app. Whether you use only custom icons or mix custom and system-provided ones, all interface icons in your app need to use a consistent size, level of detail, stroke thickness (or weight), and perspective. Depending on the visual weight of an icon, you may need to adjust its dimensions to ensure that it appears visually consistent with other icons.

To help achieve visual consistency, adjust individual icon sizes as necessary and use the same stroke weight in every icon.

In general, match the weights of interface icons and adjacent text. Unless you want to emphasize either the icons or the text, using the same weight for both gives your content a consistent appearance and level of emphasis.

If necessary, add padding to a custom interface icon to achieve optical alignment. Some icons — especially asymmetric ones — can look unbalanced when you center them geometrically instead of optically. For example, the download icon has more visual weight on the bottom than on the top, which can make it look too low if it's geometrically centered.

In such cases, you can slightly adjust the position of the icon until it's optically centered. When you create an asset that includes your adjustments as padding around an interface icon, you can optically center the icon by geometrically centering the asset.

Adjustments for optical centering are typically very small, but they can have a big impact on your app's appearance.

Provide a selected-state version of an interface icon only if necessary. You don't need to provide selected and unselected appearances for an icon that's used in standard system components such as toolbars, tab bars, and buttons. The system updates the visual appearance of the selected state automatically.

In a toolbar, a selected icon receives the app's accent color.

Use inclusive images. Consider how your icons can be understandable and welcoming to everyone. Prefer depicting gender-neutral human figures and avoid images that might be hard to recognize across different cultures or languages.

Include text in your design only when it's essential for conveying meaning. For example, using a character in an interface icon that represents text formatting can be the most direct way to communicate the concept. If you need to display individual characters in your icon, be sure to localize them. If you need to suggest a passage of text, design an abstract representation of it, and include a flipped version of the icon to use when the context is right-to-left.

If you create a custom interface icon, use a vector format like PDF or SVG. The system automatically scales a vector-based interface icon for high-resolution displays, so you don't need to provide high-resolution versions of it. In contrast, PNG — used for app icons and other images that include effects like shading, textures, and highlighting — doesn't support scaling, so you have to supply multiple versions for each PNG-based interface icon. Alternatively, you can create a custom system icon and specify a scale that ensures the symbol's emphasis matches adjacent text.

Provide alternative text labels for custom interface icons. Alternative text labels — or accessibility descriptions — aren't visible, but they let assistive technologies audibly describe what's onscreen, simplifying navigation for people with visual disabilities.

Avoid using replicas of hardware products. Hardware designs tend to change frequently and can make your interface icons and other content appear dated. If you must display hardware, use only the images available in system design resources or the system icon set that represent various products.

## Standard icons

For icons to represent common actions in menus, toolbars, buttons, and other places in interfaces, you can use these system icons.

| Action | Icon | Symbol name |
|--------|------|-------------|
| Cut | scissors | scissors |
| Copy | document.on.document | document.on.document |
| Paste | document.on.clipboard | document.on.clipboard |
| Done | checkmark | checkmark |
| Save | | |
| Cancel | xmark | xmark |
| Close | | |
| Delete | trash | trash |
| Undo | arrow.uturn.backward | arrow.uturn.backward |
| Redo | arrow.uturn.forward | arrow.uturn.forward |
| Compose | square.and.pencil | square.and.pencil |
| Duplicate | plus.square.on.square | plus.square.on.square |
| Rename | pencil | pencil |
| Move to | folder | folder |
| Folder | | |
| Attach | paperclip | paperclip |
| Add | plus | plus |
| More | ellipsis | ellipsis |
| Select | checkmark.circle | checkmark.circle |
| Deselect | xmark | xmark |
| Text formatting | | |
| Superscript | textformat.superscript | textformat.superscript |
| Subscript | textformat.subscript | textformat.subscript |
| Bold | bold | bold |
| Italic | italic | italic |
| Underline | underline | underline |
| Align Left | text.alignleft | text.alignleft |
| Center | text.aligncenter | text.aligncenter |
| Justified | text.justify | text.justify |
| Align Right | text.alignright | text.alignright |
| Search | magnifyingglass | magnifyingglass |
| Find | text.page.badge.magnifyingglass | text.page.badge.magnifyingglass |
| Find and Replace | | |
| Find Next | | |
| Find Previous | | |
| Use Selection for Find | | |
| Filter | line.3.horizontal.decrease | line.3.horizontal.decrease |
| Share | square.and.arrow.up | square.and.arrow.up |
| Export | | |
| Print | printer | printer |
| Account | person.crop.circle | person.crop.circle |
| User Profile | | |
| Dislike | hand.thumbsdown | hand.thumbsdown |
| Like | hand.thumbsup | hand.thumbsup |
| Bring to Front | square.3.layers.3d.top.filled | square.3.layers.3d.top.filled |
| Send to Back | square.3.layers.3d.bottom.filled | square.3.layers.3d.bottom.filled |
| Bring Forward | square.2.layers.3d.top.filled | square.2.layers.3d.top.filled |
| Send Backward | square.2.layers.3d.bottom.filled | square.2.layers.3d.bottom.filled |
| Alarm | alarm | alarm |
| Archive | archivebox | archivebox |
| Calendar | calendar | calendar |

## Desktop

Document icons are important for desktop apps that support custom file types. If your desktop app can use a custom document type, you can create a document icon to represent it. Traditionally, a document icon looks like a piece of paper with its top-right corner folded down. This distinctive appearance helps people distinguish documents from apps and other content, even when icon sizes are small.

If you don't supply a document icon for a file type you support, the system creates one for you by compositing your app icon and the file's extension onto the canvas.

In some cases, it can make sense to create a set of document icons to represent a range of file types your app handles. For example, development tools use custom document icons to help people distinguish projects, objects, and code files.

To create a custom document icon, you can supply any combination of background fill, center image, and text. The system layers, positions, and masks these elements as needed and composites them onto the familiar folded-corner icon shape.

System design resources provide templates you can use to create a custom background fill and center image for a document icon.

Design simple images that clearly communicate the document type. Whether you use a background fill, a center image, or both, prefer uncomplicated shapes and a reduced palette of distinct colors. Your document icon can display as small as 16x16 px, so you want to create designs that remain recognizable at every size.

Designing a single, expressive image for the background fill can be a great way to help people understand and recognize a document type.

Consider reducing complexity in the small versions of your document icon. Icon details that are clear in large versions can look blurry and be hard to recognize in small versions.

Avoid placing important content in the top-right corner of your background fill. The system automatically masks your image to fit the document icon shape and draws the white folded corner on top of the fill.

If a familiar object can convey a document's type or its connection with your app, consider creating a center image that depicts it. Design a simple, unambiguous image that's clear and recognizable at every size.

Define a margin that measures about 10% of the image canvas and keep most of the image within it. Although parts of the image can extend into this margin for optical alignment, it's best when the image occupies about 80% of the image canvas.

Specify a succinct term if it helps people understand your document type. By default, the system displays a document's extension at the bottom edge of the document icon, but if the extension is unfamiliar you can supply a more descriptive term.

## Related

App icons, System icon set
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall