Primitives
Base CSS patterns for form semantics, identity, status and shortcuts. These primitives stay HTML-first and are meant to support more complex components later.
Field
A semantic wrapper for label, description and validation messages. Use .field as the default form primitive instead of inventing ad-hoc spacing around each input.
Used for login, receipts and important product updates.
Avatar
Identity token for people, workspaces and bots. Starts as CSS-only with image, initials and stack patterns.
Sizes
With image
Renata Silva
Design systems
Stack
Indicator
Small status signal for presence, sync state, live activity and inline health.
Kbd
Shortcut hints and keyboard references. Keep them compact and reserved for actual keyboard actions.
Quick search ·Ctrl +K
Close overlay ·Esc
Usage rules
Do
- Use
.fieldas the default wrapper around form controls - Prefer initials fallback for avatars when image loading is optional
- Pair indicators with text in any critical state
- Use
kbdonly for real keyboard interactions
Don't
- Don't replace labels with placeholders inside fields
- Don't use avatar color alone as an identity cue when initials fit
- Don't show isolated pulsing dots without semantic text nearby
- Don't overload screens with shortcut hints that compete with the main content