Skip to content
Docs menu

Showpieces.

Library items that move in ways CSS alone cannot: backdrops that answer the pointer, scenes that play as you scroll, things you drag and throw.

How they differ from other items

  • They paste the same way and take props the same way.
  • Their motion comes from the EtchPress runtime, a small script. On WordPress it is a plugin. In Etch Studio it is a set of files.
  • A page loads only what its own showpieces need. A page with none loads almost nothing.

A showpiece is complete without the runtime. If the runtime is missing or switched off, it shows a still version: the same content, laid out plainly.

On a phone

Every showpiece has a behaviour designed for touch. Where a mouse hovers, a finger drags or the page's scroll does the work. A finger on a showpiece can always scroll the page.

Reduced motion

Visitors who ask their device for less motion get the still version. Nothing to set up.

Two that need a word

  • Ripple reads the pixels of its picture, so the picture must be on your own site. A picture served from another domain shows as a plain picture.
  • Falling tags uses Matter.js for its physics. It ships with the runtime and loads only on pages that use that item.

Set up the runtime