Apple HIG + Liquid Glass

Design System
Documentation

A comprehensive reference for building interfaces with Apple's Human Interface Guidelines and Liquid Glass design language — adapted for web, React, SaaS, and dashboards.

21 Doc Files
50+ Components
9 Core Principles
200+ Design Rules
7 Skills
What's Inside

Everything You Need to Build Like Apple

From foundational principles to live component demos — every aspect of the design system is documented and ready to use.

Live Preview

Design System in Action

Every component is live — rendered exactly as it appears in production interfaces.

Liquid Glass

Translucent surfaces that respond to the content beneath them.

Display
Title — Semibold
Body text reads naturally at this size and weight.
CAPTION · FOOTNOTE
Blue
Green
Red
Orange
Purple
Pink
Teal
Indigo

What's Documented

Design Principles (9)
The philosophical foundation — Clarity, Hierarchy, Depth, Feedback, Consistency, Content Focus, Affordance, Adaptability, Native Thinking.
Liquid Glass System
Material properties, refraction levels, specular highlights, contextual opacity, and implementation patterns for web.
Color System
Full semantic palette, adaptive light/dark tokens, accent variants, fill layers, border colors, and glass surface colors.
Typography Scale
Display to Caption with SF Pro, fluid sizing with clamp(), weights, line-heights, letter-spacing, and role-based usage.
50+ Components
Buttons, Cards, Badges, Chips, Inputs, Modals, Sheets, Toasts, Tabs, Segmented Controls, Switches, Progress, Lists, Tables.
UI Checklist
Pre-launch review checklist covering accessibility, motion, touch targets, contrast, and HIG compliance.

How to Use This System

1
Start with Foundations
Read the Design Principles page first. These 9 principles are the decision-making framework behind every component and pattern in the system.
2
Understand Liquid Glass
Learn the visual language — translucency levels, blur values, specular highlights, and when to use glass vs. opaque surfaces in your layouts.
3
Copy the CSS Tokens
The design-system.css file defines all tokens on :root with automatic dark mode support via [data-theme="dark"].
4
Use Component Classes
Every component has ready-to-use CSS classes. Use .card, .btn, .badge and their modifiers directly in HTML or map them to React components.
5
Check the Do's & Don'ts
Before shipping, review the Do's & Don'ts page and run through the UI Checklist to ensure HIG compliance and design quality.
6
Reference Tokens for Custom Work
When building custom components, always reach for CSS variables like var(--color-accent) instead of hard-coded values to maintain theme consistency.
All Sections

Browse the Full Documentation

Every page in the system — 21 documentation files covering every aspect of the Apple HIG Liquid Glass design language.

Start Building Apple-Like Interfaces

Every principle, component, and token you need — documented, demonstrated, and ready to ship.