# IOS Styleguide

> Design and UI style guide for iOS apps. Premium consumer aesthetic, brand-forward native. Use when this capability is needed.

- Skill: `tomevault-io/ios-styleguide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ios-styleguide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ios-styleguide/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ios-styleguide

---


## Purpose

Enforce taste, restraint, and platform excellence. Complements security, NFR, and coding standards skills.

For brand identity (colors, fonts, design direction, anti-patterns), see `/shared-brand`.

**Platform addition:** brand-forward native — unmistakably crafted, never templated.

## Typography (iOS-specific)

- System font (San Francisco) preferred for body and controls
- Display typography may be brand-forward and expressive
- Must survive Dynamic Type increases without layout failure

## Liquid Glass (Apple's material system)

### Appropriate uses

- Navigation chrome (top bars, tab bars)
- Sheets, modals, transient overlays
- Elevated surfaces conveying depth
- Hero/focus containers reinforcing hierarchy

### Never use on

- Dense lists
- Primary reading surfaces
- Form fields and input-heavy views
- Backgrounds for long-form text

**Rule:** Liquid Glass must convey hierarchy or focus, not decoration. If the purpose isn't clear, don't use it.

## iOS-specific anti-patterns

- Default SwiftUI previews shipped unchanged
- Boilerplate list-card patterns across screens
- iPhone layouts scaled up for iPad
- Decorative transitions or over-animated navigation
- Translucency that reduces legibility

## Device support (mandatory)

- iPhone and iPad
- Adaptive layouts using size classes
- Support split view and multitasking
- Design for portrait and landscape

If a screen looks identical on iPhone and iPad, it likely underuses the platform.

## Reference

For Swift tokens, adaptive layout patterns, and Liquid Glass examples, see `reference/ios-styleguide-reference.md`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/edfenton) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

