Documentation
Icons, Colors & Menu Bar
Style your cards and control how they show up in the macOS menu bar.
Icons
Two icon options for cross-platform support.
Icon Resolution Order
TailStats resolves icons in this order:
- macOS/iOS: Use
icon(SF Symbol) if provided and valid - macOS/iOS fallback: Use
emojiificonis missing or invalid - Android: Always use
emoji(SF Symbols not supported) - No icon: If neither is provided, no icon is displayed
| Field | Platform | Description |
|---|---|---|
| icon | Apple only | SF Symbol name (e.g., "heart.fill") |
| emoji | All platforms | Emoji character (e.g., "❤️") |
Recommendation: Always provide both icon and emoji for cross-platform compatibility.
Common SF Symbols
heart.fill
dollarsign.circle
chart.line.uptrend.xyaxis
server.rack
person.fill
checkmark.circle.fill
exclamationmark.triangle.fill
bell.fill
wifi
Full list: SF Symbols App
Colors
Color fields (color, iconColor, menuBarBackground) accept hex colors or named colors.
Hex Colors
"#FF5500"
"#F50"
Named Colors
red
green
blue
orange
yellow
purple
pink
gray
cyan
teal
indigo
brown