pproenca avatar

Ios Design System

This is the infrastructure layer for building a SwiftUI design system, not just using one. It covers token architecture (raw, semantic, component layers), asset catalog governance, and the Airbnb DLS pattern of style protocols over wrapper views. Mandates @Equatable on every view and keeps everything compatible with the clinic modular MVVM-C boundaries (Feature depends on Domain + DesignSystem only). You'd reach for this when setting up or refactoring the design system package itself, not when just styling a feature screen. It's strict about preventing hardcoded hex values and shadow tokens, with 50 rules across color engineering, typography scales, spacing systems, and theme infrastructure. Works alongside swift-ui-architect for the architecture side and ios-design for actually using the primitives you build here.

skills.sh installs
319
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill ios-design-system --agent claude-code

Installs into .claude/skills of the current project.

Files

Airbnb iOS Design System Best Practices

Opinionated, strict design system engineering for SwiftUI iOS 26 / Swift 6.2 apps. Contains 50 rules across 8 categories, prioritized by impact. Derived from Airbnb's Design Language System (DLS), Airbnb Swift Style Guide, Apple Human Interface Guidelines, and WWDC sessions. Mandates @Equatable on every view, @Observable for state, and style protocols as the primary component API.

Mandated Architecture Alignment

This skill is designed to work alongside swift-ui-architect. All code examples follow the same non-negotiable constraints:

  • Feature modules depend on Domain + DesignSystem; no direct Data dependency
  • @Observable for mutable UI state, ObservableObject / @Published never
  • @Equatable macro on every view
  • Style protocols as the primary component styling API (Airbnb DLS pattern)
  • Asset catalog as the source of truth for color values
  • Local SPM package for design system module boundary

Scope & Relationship to Sibling Skills

This skill is the infrastructure layer — it teaches how to BUILD the design system itself. When loaded alongside sibling skills:

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
Frontend Development, Code Review & Quality, Cloud & Infrastructure, Mobile Development, Design & UI/UX
First seen
Jun 3, 2026

More from pproenca/dot-skills

All 100
1borghei avatarsenior-fullstackborghei/claude-skillsFullstack development toolkit with project scaffolding for Next.js/FastAPI/MERN/Django stacks and code quality analysis. Use when scaffolding new projects, anal318skills.sh installs
2onewave-ai avatardesign-system-generatoronewave-ai/claude-skillsCreate design systems with tokens, components, and documentation. Use when building design systems, creating component libraries, or establishing design tokens.317skills.sh installs
3onewave-ai avatarerror-boundary-creatoronewave-ai/claude-skillsCreate error boundaries, error handling, and fallback UIs for React applications. Use when implementing error handling, creating fallback components, or setting311skills.sh installs
4davila7 avatarremotion-best-practicesdavila7/claude-code-templatesBest practices for Remotion - Video creation in React310skills.sh installs
5pedronauck avatararchitecture-diagrampedronauck/skillsCreate professional, dark-themed architecture diagrams as standalone HTML files with SVG graphics. Use when the user asks for system architecture diagrams, infr303skills.sh installs
6nexu-io avatarweb-prototypenexu-io/open-designGeneral-purpose desktop web prototype. Single self-contained HTML file built by copying the seed `assets/template.html` and pasting section layouts from `refere301skills.sh installs