Stop rebuilding buttons, forms, and navigation chrome from scratch. HIGDesign gives you 35 production-ready components, a layered token system, and one-line theme switching — so your app looks native on iPhone, iPad, Mac, Apple TV, Apple Watch, and visionOS.
HIGShowcase on iPhone · system theme · light mode
🎨 Live component gallery · Docs · Releases
A Swift Package with HIG-correct SwiftUI components, design tokens, and themes. Import one product, wrap your app in HIGThemeableView, and use HIGButton, HIGTextField, HIGTabBar, and 32 more — each styled from tokens, not hardcoded values.
SwiftUI-first. Optional UIKit/AppKit bridging in HIGBridging when needed. Swift 6. iOS 18+, macOS 15+, visionOS 2+, tvOS 18+, watchOS 11+.
| Raw SwiftUI | HIGDesign |
|---|---|
| You style every control yourself | 35 pre-built, HIG-aligned components |
| Spacing and colors drift across screens | Token layers enforce consistency |
| Brand theming means touching every view | Swap theme at the root — everything updates |
| Multi-platform means re-solving the same patterns | Platform-appropriate behavior built in |
| Marketing gallery | Device-framed showcase snapshots for README and GitHub Pages |
Native SwiftUI is the foundation. HIGDesign is the opinionated layer that saves weeks of design-system work while keeping you aligned with Apple Human Interface Guidelines.
1. Add the package — Xcode → Add Package Dependencies:
https://github.com/S-M-Technology-Ltd/HIGDesign.git
(from 1.3.0)
2. Wrap your app:
import HIGDesign
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
HIGThemeableView(theme: HIGSystemTheme()) {
VStack(spacing: 16) {
HIGTextField("Email", text: $email, placeholder: "you@example.com")
HIGToggle("Notifications", isOn: $notifications)
HIGButton("Continue", role: .primary) { }
}
.higPadding(.screenEdge)
}
}
}
}That's it. Full guide → Docs/HOW_TO_USE.md
Run the interactive showcase locally:
git clone https://github.com/S-M-Technology-Ltd/HIGDesign.git && cd HIGDesign
open Sample/HIGDesignSample.xcodeproj # iOS + macOS catalog
swift run HIGShowcaseApp # macOS CLI showcaseBrowse all components online → s-m-technology-ltd.github.io/HIGDesign
| Components | |
|---|---|
| Actions | Button, Menu Button |
| Inputs | Text Field, Secure Field, Search Field, Text Editor, Long Text Editor, Picker, Photo Picker (iOS), Photo Editor |
| Controls | Toggle, Checkbox, Radio, Segmented Control, Slider, Stepper |
| Content | Label, Badge, Icon, Heroicons (324 outline + solid), Avatar, Link, Tag, Bullet List |
| Layout | Divider, Card, List, Form Section |
| Navigation | Tab Bar, Toolbar, Sidebar, Navigation Bar |
| Feedback | Progress View, Activity Indicator, Alert, Toast |
Themes: System · High Contrast · Brand accent — each with light and dark variants.
- Layered tokens —
Raw → Semantic → Component → Theme(no magic numbers in views) - Environment-driven theming —
@Environment(\.higTheme)everywhere - Modular SPM products —
HIGDesignumbrella,HIGDesignIcons, orHIGDesignCore+HIGDesignComponents - Heroicons v2 — 324 outline and solid icons via
HIGHeroIconToken, themed sizing, and Dynamic Type scaling - DocC catalog — open in Xcode → Product → Build Documentation
- CI-verified — token guards, unit tests, six-platform builds
| Component gallery | Visual marketing site |
| HOW_TO_USE.md | Integration & theming |
| Swift Package Index | Builds & API browser |
| CHANGELOG.md | Release notes |
| ARCHITECTURE.md | Module graph (for contributors) |
| Requirements | Per-module requirements |
PRs welcome. Run before submitting:
Scripts/build_all_platforms.sh
swift test
Scripts/verify_sample_xcode_project.shMIT — see LICENSE. Apple platform trademarks belong to Apple Inc.
If HIGDesign saves you time, consider ⭐ starring the repo — it helps other developers find it.