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 |