Skip to content

Moments

Every moment in the first version, with the default theme’s effect. For what moments are, see Moments and effects.

The moments

Moment When Default effect Other built-in choices
entry.delete an entry, row or card is deleted dust (the card breaks into grains that blow away) fade, shrink, slide away, fold, none
entry.restore Undo brings it back dust in reverse fade in, none
checkbox.tick a checkbox is ticked pop + confetti pop, sparkle, burst, fireworks, hearts, stars, glow, none
checkbox.untick a checkbox is unticked small un-pop fade, none
entry.create a new entry appears soft rise pop, slide in, none
allDone the last open item in a view is ticked big celebration fireworks, confetti rain, none
timer.finish a stopwatch or timer reaches its goal ring pulse glow, confetti, none
drop a dragged card lands settle bounce none
error an action could not be done small shake none
page.open a page or peek opens quick fade slide, zoom, none

New moments join as the app grows, always with a default in every built-in theme.

The engines

Every effect is built from one of these safe engines. You tune them with settings, no code.

Engine Makes Settings
Dust the disintegration grain size, direction, how long, how much it spreads
Particles confetti, sparkle, fireworks, hearts, stars, snow shape (paper, star, heart, dot, an emoji, or an uploaded picture), colours (theme colours by default), how many, spread, gravity, how long, where it starts
Motion pop, bounce, shake, wobble, flip, slide, fade, shrink, rise size, distance, how long, the easing
Glow glow, ring pulse, ripple colour, size, how long
Animation file anything an uploaded Lottie file, cleaned on upload

A recipe is an engine plus its settings. confetti is the particles engine with paper shapes in theme colours. Save your own recipe in the theme’s recipes and use it on any moment.

The exact key names of each engine’s settings are not decided yet, except effect and count.

In settings

{
"moments": {
"entry.delete": { "effect": "dust" },
"checkbox.tick": { "effect": "confetti", "count": 80 },
"allDone": { "effect": "fireworks" },
"page.open": { "effect": "none" }
},
"motion": { "level": "normal" }
}

A collection, view or entry can change a moment for its own place. A value rule can change it too: “when ticked and the streak is 30 or more, play fireworks”.

motion.level

Value What it does
off no effects
calm keeps small effects, drops big celebrations
normal the theme’s effects
extra bigger celebrations

If your device asks for reduced motion, every effect becomes a simple fade or nothing, whatever the theme says.

Rules every effect follows

Rule Detail
The change comes first a deleted card leaves the list at once; the dust plays from a picture of it. A ticked box is ticked in the same frame; confetti starts on the next
Off the main work big effects draw on their own canvas in a background worker; small ones use only movement and fading
A cap per device each engine has a limit, with fewer grains and particles on phones
No flashing an effect that flashes more than 3 times a second is refused
Never on protected screens no effect plays over sign-in, “Delete for good” and the rest
Settings, not code so a Library theme’s effects are safe to turn on

The other modular parts

These follow the same rules and change per place too.

Part What the theme decides Default
Icons the icon set (built-in sets share the same names), stroke width, size the house set
Haptics (phone) the small vibration per moment: none, light, medium, success, warning light on tick, success on allDone, warning on error
Sounds (later) a sound per moment, from a built-in pack or an uploaded short sound off
Transitions how pages, peeks, sheets and dialogs open and close quick fade and slide
Empty states what an empty view shows: nothing, a short line, or a picture a short line
Emoji the system’s emoji, or one built-in emoji style the system’s