Illustration
StableA small drawing for empty, error, permission and success screens, in dark lines with one green touch.
Also known as spot illustration, artwork, image
Install with npm install @tattva/ui (setup), or copy the code from the kit in Downloads.
Three sizes
<Illustration name="no-results" size={64} />
<Illustration name="no-results" size={96} />
<Illustration name="no-results" size={160} />Line thickness grows with size, so the drawing looks balanced at each size.
When to use it
A small drawing that sets the tone of an empty, error or success screen. It shows one idea in dark lines with one green touch, and follows light and dark mode.
Made of: Dark outline · Light fill · Sand fill · Green touch
Use it for
- An empty, first-use or cleared screen.
- An error, offline, permission or usage limit screen.
- Inside EmptyState, which picks a drawing for you.
Not for
- Small areas, headings or lists of features: use Pictogram.
- A photo or generated image: use MediaFrame.
- An icon inside a button: use IconButton.
Do and avoid
No trips match these dates.
Do
- Use it to support the words on a screen, never to replace them.
- Pick the drawing that matches the message, so the picture and words agree.
- Leave it as decoration when the words beside it already say everything.
- Show one drawing per area.
Avoid
- Do not use it as decoration on busy screens.
- Do not add robots, brains, glowing orbs or sparkles to new drawings.
- Do not give it fixed colors. Use the theme colors so dark mode works.
- Do not use amber in the drawing. Amber is for words that ask a person to act.
On a phone
- Illustration is a fixed 64, 96 or 160px and does not scale with the screen, so choose 64 or 96 on a phone.
- It is not tappable and has no text, so nothing changes on touch screens.
Seen in products
- Atlassian's illustration guidance defines a small set of illustration types, each with a defined job. A spot illustration shows one concept and is used for empty, error and celebration states.
- Atlassian says most cases call for existing brand assets and that custom work is for major launches. It says illustration should support copy rather than replace it, and that decoration-only images in product should be avoided.
- Atlassian warns that too many illustrations increase cognitive load, and that colorful spots add emphasis while neutral spots suit routine tasks.
- Polaris empty-state illustrations are described in search snippets as 226 x 226 px, with fine detail rarely smaller than 4px and built-in negative space so visual weight matches.
- Opinion pieces name purple gradients, glowing brains, chrome robot hands, nodes, sparkles and orbs as the visual cliché of AI products.
Properties
| Prop | Type | Default | Description |
|---|---|---|---|
| namerequired | IllustrationName | none | One of empty-chat, no-results, error, permission, offline, rate-limit, success, upload, first-run. |
| size | 64 | 96 | 160 | 96 | Rendered size in px. Sets the stroke weight too. |
| title | string | none | Accessible name. Without it the art is aria-hidden. |
| className | string | none | Extra classes for the svg element. |
"Show code under the preview gives the code for the example on the stage."
Tokens
Change one of these and every part that uses it follows.
--fg--surface--surface-sunken--lime
Built in
- Without a title, screen readers skip the drawing.
- With a title, screen readers read it as a picture and say the title.
- The keyboard never stops on it.
- The drawing does not move, so there is no motion to turn off.
What you need to do
- Leave out the title when the nearby words already say what happened, which should be almost always.
- Give a title only when the drawing adds meaning that the words do not.
Built toward WCAG 2.2 AA and checked automatically; no independent audit yet. Read the accessibility guide