Sizing Colors Layout Controls Indicators Recipes

Ada UI

Typography

--text-3xl 1.8rem Headline 1, Text in Compound Commands

--text-2xl 1.6rem Headline 2

--text-xl 1.4rem Headline 3

--text-lg 1.2rem Headline 4

--text-base 1rem Normal Text, Command Label, Tile Header

--text-sm 0.85rem Small Text, Panel Footer

--text-xs 0.75rem Tile Footer

Sizing

Padding

--padding-xs 0.15rem
--padding-sm 0.4rem
--padding 0.75rem
--padding-lg 1rem

→ Paddings are responsive (in rem).

Usage: paddings, anything which should grow/shrink with the root font-size

Spacing

--spacing-xs 2px
--spacing-sm 6px
--spacing 10px
--spacing-lg 14px

→ Spacings are not responsive (in px).

Usage: spacings, gaps, anything which should be stable regardless of the font-size

Scaling

By adding the class scaled and setting the CSS custom property --scaled to a number like 1.5, every responsive token (sizes, paddings, font-size) is scaled in this scope. See the scaled tile as an example:

Scaled Tile (factor 1.5)

Colors

Primary

100
500
600
700
800
950

Tone 1

100
500
600
700
800
950

Tone 2

100
500
600
700
800
950

Tone 3

100
500
600
700
800
950

Tone 4

100
500
600
700
800
950

Warn

100
500
600
700
800
950

Usage

100 Text Color 500 Active/Focus State 600 Border/Flash Color 700 Corner Color 800 Command Color 950 Background

Layout

Page Layout

Choose yourself whether the body should scroll or the body should have a fixed width of 100%. For the latter, you should use one or more top-most panels which then will scroll their content.

You can see both options and how to implement them by toggling the class height-100 on the html element of this demo page.

Panel

Without Header and Footer

Content

With Header and Footer

Header
Content
Footer

With another color variant

Header
Content
Footer

With a Command Dock

Docked in the Header
Header
Content
Footer
Docked in the Footer
Header
Content
Footer

Stacking

The panel has a translucent background, so when stacking multiple panels the background changes slightly with each level.

Content

Tile

A tile holds text: a header, a value and a footer. Commands, inputs and headings in the tile body belong in a panel, since a tile's surface is tuned for its own ink only.

Tile Content
Tile Content
Tile Content
Tile Content
Tile Content
Tile Content

With Header

The header names what the tile shows, the article holds the value.

Storage
48.2 GB
Uptime
99.9%
Requests
1,284
per minute
Errors
23
last hour

Controls

Command

Thin

Outline

With outline-in-light the command is rendered as outline variant in light mode only.

Flashing

With reduced motion requested by the system, a command pulses three times slowly, then a dot in its corner keeps marking it.

Disabled

Abbreviations for small screens

When rendered on small screens (<640px) an abbreviation can be used to reduce the space a command needs. When doing so, the text node of the command should be empty and two data- attributes should be used: data-label and data-abbr.

In order to see the difference below, reduce/increase the browser window width.

Wrapping

The command's text is wrapped by default which increases the height of the command.

If you want to use ellipsis and a single line of text, a wrapper element is needed. See page's source code for details.

Double check if ellipsis is really needed and if yes, that the full text is visible with another interaction (no tooltip, since not mobile friendly and not in the sense of the Ada look and feel).

Compound

Thin
With Text
47
Vertical

Input

Disabled

Indicators

Spinner

With reduced motion requested by the system, the spinner turns three times slower instead of stopping, so it never looks frozen.

80px

32px

16px

Meter

Shows a quantity. Set --value inline to a number between 0 and 1 (out-of-range values are clamped), and give the element role="meter" with its aria-value* attributes, since the fill itself is decoration.

Battery
CPU load
Free disk space

Segmented

Vertical

A vertical meter takes its parent's height, so the parent needs a definite one, or the meter collapses to nothing.

Chip

A small, non-interactive block for keys, codes, tags and statuses. It uses the command's colours, so its contrast is whatever the theme tunes for commands. Anything clickable should be a command thin instead.

Draft Shipped v8.2.0 Docs In review Blocked

Inline in text: release v8.2.0 is Blocked on one review.

Recipes

Patterns built from existing components. Ada ships no class for them; the layout is a few lines of grid in your own stylesheet. See the page's source code for details.

Bar List

Labelled values compared at a glance: a chip, a meter and the value. Colour marks a state, the number carries the value.

Rent
€950 of €950 Groceries
€412 of €500 Transport
€96 of €120 Eating out
€187 of €150 Hobbies
€45 of €100

Status Log

Coded lines in an ordered list. The colour sits in the chip, the text stays in the body colour.

  1. 01Checkout
  2. 02Install dependencies
  3. 03Build
  4. 04Test: 2 failed
  5. 05Deploy: skipped