Repository navigation
v0.0.1
First public release.
Added
- Engine: any React Native view is snapshotted with Skia
makeImageFromView, cut into grains drawn
with one<Atlas>, and animated on the UI thread with Reanimated 4 and react-native-worklets.
One reaction pass per frame, idle grains skipped, grain counts capped at 6000 per burst. DissolveProvider: a full screen,pointerEvents="none"overlay that draws every effect and
respects reduced motion.- Variants:
- Classic presets:
dust,sand,ember,pixel,vortex. - Exits:
snap,fling,stream,shatter,pile,melt. - Entrances:
gather,rain,print. - Gestures:
charge(hold to burst),peel(peel off like a sticker). - Transitions:
morph(view A becomes view B).
- Classic presets:
- Common options on every atlas preset:
origin,direction(any exit plays backwards as an
entrance),grain,duration,hapticsand free numeric knobsn. - The
cascadedelay field (field: 'cascade'withrows): list rows leave in a diagonal wave. - Hooks and components:
useDissolvefor exits.DissolveInanduseAppearfor entrances.useDissolveScrubfor finger driven, reversible effects.useDissolveHoldfor hold to confirm.useDissolvePeelto peel a view by hand from any corner or edge.useDissolveScreenfor full screen transitions.useDissolveMorphto turn one view into another.usePileto sweep or clear the grains left bypile.
- Expo Router example app with demo screens for every variant and a playground.
- Static docs and showcase website in
web/, with a live Canvas 2D port of the engine. - Claude skill (
web/skills/dissolve/SKILL.md) and an agent prompt page. - Dependency free MCP server (
mcp/server.mjs) exposing the docs as tools.
npm: https://www.npmjs.com/package/react-native-dissolve/v/0.0.1