Skip to content

States and words

What a screen shows when it is empty, loading, wrong, selected or done, and the words it uses to say so.

A screen is more than its default view. Each state below has a small, fixed shape, and each is named in the screen's plan before it is built. The Finish Review checks them on the built screen.

Empty on first use

Harbour studio
  • Home
  • Invoices
  • Customers
  • Payments
  • Settings

Invoices

InvoiceCustomerStatusAmount
No invoices yet

An empty state is a title line, at most one sentence and at most one action, with no illustration, and the header and the table's head stay in place. On first use the action creates the first item, and it is outlined because the header already holds the screen's one filled button.

Empty after a filter

Harbour studio
  • Home
  • Invoices
  • Customers
  • Payments
  • Settings

Invoices

5 invoices, £4,320.00 outstanding

InvoiceCustomerStatusAmount
No invoices match “Harlow”

When a person's own search or filter empties the list, the screen says so and offers to clear it. Where nothing on the screen can fill the list, the empty state has no action.

Loading that keeps its size

Harbour studio
  • Home
  • Invoices
  • Customers
  • Payments
  • Settings

Invoices

Loading invoices…

InvoiceCustomerStatusAmount

A loading region keeps its final size and says what is loading, so the content arrives without moving the page. Press Refresh to watch the rows replace their skeletons in place.

A running action on its button

INV-2051
INV-2050
INV-2049

A running action names itself on its own button and disables it until it is done. The spinner turns only while the work lasts.

An error beside its field

An error says what happened and the next step, where it happened: beside the field, in the form, in the run. A local fault never becomes a full-page error.

Done, with Undo

Harbour studio
  • Home
  • Invoices
  • Customers
  • Payments
  • Settings

Invoices

4 invoices

InvoiceCustomerAmountActions
INV-2051Brightwater Dental£1,280.00
INV-2050Kestrel Print Co£640.00
INV-2049Oakline Joinery£2,400.00
INV-2048Pennant Cycles£915.00

An edit or a delete runs at once, and one neutral toast with at most one action offers Undo; quick deletes share that toast. A confirmation is kept for what cannot be undone.

Selection and its bulk bar

Harbour studio
  • Home
  • Invoices
  • Customers
  • Payments
  • Settings

Invoices

5 invoices, £4,320.00 outstanding

InvoiceCustomerStatusAmount
INV-2051Brightwater DentalOverdue£1,280.00
INV-2050Kestrel Print CoSent£640.00
INV-2049Oakline JoinerySent£2,400.00
INV-2048Pennant CyclesPaid£915.00
INV-2047Fernhill BakeryDraft£350.00
2 invoices selected

A selected row takes a neutral fill. Bulk actions arrive in a bar once rows are selected, and the bar states the count.

Disabled

A disabled control is the same control at reduced opacity. A disabled menu item says why: open More actions to read the reason.

A label starts with a verb

INV-2051

A button starts with a verb and names the outcome. Titles, buttons and labels are sentence case.

A label says its number

Where the outcome has a number, the label says it. The number follows the selection, down to the singular.

A count with its noun

Harbour studio
  • Home
  • Invoices
  • Customers
  • Payments
  • Settings

Customers

5 customers, 9 invoices

CustomerBilledOutstanding
Brightwater Dental3 invoices£1,280.00
Kestrel Print Co2 invoices£640.00
Oakline Joinery2 invoices£2,400.00
Pennant Cycles1 invoice£0.00
Fernhill Bakery1 invoice£0.00

A count carries its noun, in a cell as in the one line under the title. That line states a count, a scope or a status, and never restates the title.

Work in progress, and done

Imported 48 customers
Matching 9 invoices…

Work in progress is the verb in "-ing" with an ellipsis, and done is the past tense. Khaeli's product pipeline runs its copy rules over every label before the owner sees the screen.