Writing

FoundationsFoundations

Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/writing. This file is a structured index of that content, snapshot 2025-02-02. Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.

Writing

Getting started

Determine your app’s voice.

Match your tone to the context.

Be clear.

Write for everyone.

Best practices

Be action oriented.

Build language patterns.

Adopt capitalization rules that align with your app’s style, then apply them consistently.

Give clear guidance and use consistent language throughout processes with multiple steps.

Use possessive pronouns sparingly.

Write for how people use each device.

Provide clear next steps on any blank screens.

Write clear error messages.

Choose the right delivery method.

Keep settings labels clear and simple.

Show hints in text fields.

Platform considerations

Resources

Videos

Change log


For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/writing

Get HIG guidance in your AI

Install Apple HIG Skills and get expert design guidance directly in Claude Code.

npx skills add raintree-technology/apple-hig-skills
Email updates aren't configured on this deployment yet. Follow the GitHub repo (opens in new tab) for updates.