Arlo is a family of free, MIT-licensed, local-first AI agent apps: no vendor backend, ever. This system keeps Arlo's identity (a white page, indigo-tinted neutrals and exactly one indigo accent) and builds on three references: Material 3 for spacing and type, Apple's SF Symbols for icons, and Apple's Human Interface Guidelines for components. The one deliberate departure from both: buttons use one fixed corner (radius-button, 12px) instead of either system's pill or capsule, so larger buttons stay rectangular and use their space.
Foundations
The rules every screen is built from.
Content fundamentals
Voice, tone and the words Arlo uses — and never uses.
Color
One indigo accent, indigo-tinted neutrals, a light and a dark theme.
Typography
The Material 3 type scale, set in Inter, with Arlo's emphasized headings.
Spacing and layout
Material 3's 8dp spacing scale, window margins and control sizes.
Shape
Arlo's radius scale and the fixed 12px button corner.
Elevation and motion
Hairlines and tonal layers first, soft shadows second, calm motion.
Iconography
SF Symbols for every interface icon, and Arlo's own brand marks.
Components
22 components that follow Apple's Human Interface Guidelines, styled with Arlo's tokens. See all →
Alert
An alert interrupts to report a problem or confirm a consequential action (Apple: alerts); it replaces Arlo's Dialog for short decisions.
Badge
Badges label status or category in a few words; count badges show unread or pending numbers.
Button
A button starts an action; Arlo buttons follow Apple's styles (filled, tinted, gray, plain) with one fixed 12px corner, radius-button.
Checkbox
A checkbox turns an option on or off inside a form that is confirmed later (Apple: checkboxes, macOS).
List
Lists present rows of related content: settings, conversations, files (Apple: lists and tables, inset grouped style); it replaces Arlo's Table in app UI.
Menu
A menu lists actions or options in a temporary panel opened from a button, a pop-up button or a right-click (Apple: menus, context menus, pull-down buttons).
Do and don't
- Do keep one filled accent button per view, and state actions as verbs in sentence case.
- Do reach for a hairline and a tonal shift before a shadow.
- Do pair every status colour with a word and a symbol.
- Don't add a second accent, a gradient, imagery, or emoji.
- Don't round buttons beyond
radius-button, or use a pill for anything you press. - Don't use
color-text-tertiaryfor anything people must read.
Arlo Design System · generated from the design-system source by tools/build.py · SF Symbols are Apple's, licensed for apps on Apple platforms.