Developers › Interface guidelines
Materials
Glass belongs to the frame, never behind what you read. Your app asks for a role, and the system draws the material.
Window backgrounds, sidebars
Ice
Menus, popovers, panels
Fog
Controls over a picture
Mist
Behind a dialog or search
Shade
The four materials.
Rupa frames every window, menu and panel with four materials, named from nature. Each has one job.
| Material | Use it for | What it does |
|---|---|---|
| Ice (Stone in dark) | Window backgrounds and sidebars | Blurs the wallpaper once and tints it. Never shows the windows behind. |
| Fog | Menus, popovers and panels | The most see-through. A glow inside its top edge and a slight bend of what lies behind, up to about 6 px. |
| Mist | The menu bar, controls over a picture | Used only where what lies behind is a picture: the wallpaper, a photograph, a map. |
| Shade | Behind a dialog or search | Darkens what is behind a modal dialog. No blur. |
Ask for a role, not a blur.
Your app never sets a blur, a tint or an opacity. It says what a surface is, a sidebar, a menu or a toolbar over a photo, and the compositor draws the right material. That is what keeps every app consistent, and what lets the system honour Reduce Transparency and battery saver for you.
Contrast is guaranteed.
Text keeps its contrast on every material, whatever lies behind it. The compositor measures what is behind the text and strengthens the tint until it passes. You don't design for the worst wallpaper; the system does.
Do
- Use Ice for the background of every window and sidebar.
- Use Mist only over a picture.
- Test your app with Reduce Transparency on.
Don't
- Put glass behind text people read: a document, a list, a message.
- Draw your own blur or tint.
- Use Fog where Ice belongs, to look more see-through.
Turning transparency off.
With Reduce Transparency on, each material becomes solid in its own colour, and Fog keeps its glow. Inactive windows go flat in any case.
Rupa's compositor is not built yet. The materials on this page are drawn by your browser.