Repository navigation
Releases
Releases · rs-4/dissolve
v0.0.7
Added
toggle: iOS style switch whose thumb breaks into grains, flows to the other end of the track on a slight arc and reassembles there while the track fills with the on color. Tap or swipe the thumb, a selection tick per flip. React Native and React.progress-steps: steps for multi step flows in two looks.variant="numbers": numbered discs on a hairline, the current disc streams along the line in grains to the next step, filling it, and back.variant="bars": story style segments with no numbers, the fill runs on with its head gathering from grains, and sheds them as dust going back. React Native and React.elastic-slider: thick rounded slider in the spirit of the iOS Control Center. The label and value invert their color over the fill, the value rolls digit by digit, and pulled past either end the track stretches like a rubber band, then snaps back with a bounce. React Native and React.- shadcn registry: every component installs with the shadcn CLI,
npx shadcn@latest add https://dissolve.rselmi.com/r/<name>.jsonfor React and.../r/native/<name>.jsonfor React Native. Shared files (engine, kit, the React hook, tw primitives, helpers) and the theme tokens are their own items, pulled in as dependencies. Built fromregistry/byscripts/build-shadcn.mjsintoweb/r, as part ofnpm run web:stamp. Component pages show the command under the dissolve-ui one.
Changed
- Web: the rain effect draws adjacent settled grains in a row together when aligned to device pixels, reducing Canvas 2D calls as the view comes together.
v0.0.6
Changed
- The package is now
dissolve-ui. One package for everything: the React Native engine (import { DissolveProvider } from 'dissolve-ui') and the CLI (npx dissolve-ui add <name>).react-native-dissolveis deprecated: replace it withdissolve-uiin package.json and in your imports. The MCP server is nowdissolve-ui-mcp.
Added
- React on the web: all 29 components now have a React web version in
registry/web, with the same prop names as on React Native. Each one is a small'use client'wrapper (<name>.tsx) over a framework free core (<name>.core.ts) that owns the DOM, canvas, pointer handling, theme tokens and reduced motion. They need onlyreactandreact-dom19, with no runtime dependency, and they work with the Next App Router and Vite. Native only props such ashapticsare accepted, and map tonavigator.vibratewhere the browser has it. - Shared web files, copied with the components that import them:
engine.ts(the grain engine),kit.ts(easing, scope, DOM and canvas helpers,capture()of any DOM subtree),react.ts(the wrapper hook) andgl.ts(WebGL2 helper). add <names> --nativeor--webpicks the platform for that run (the site shows the command for the platform you picked), and saves it indissolve.json.initasks for the platform once, React Native or React web, with the detected answer preselected (react-nativeorexpomeans native;react-dom,nextorvitewithout React Native means web).--native,--weband--yesskip the question. The choice is saved indissolve.json({ "platform", "dir" }), andaddreads it, runninginitfirst if the file is missing. Web projects with asrc/folder install intosrc/components/dissolve.listshows the platforms each component supports. Web availability comes from the files inregistry/web.- Site: every component page has a React Native / React switch (remembered across pages). It changes the usage snippet, the install notes and the copied prompt. Props stay documented once, and native only props are tagged in React mode.
Changed (site and tooling)
- The site runs the same code as the React web components:
scripts/build-web.mjsbundlesregistry/web/*.core.tsintoweb/lib, and the demo ports inweb/cpkeep only demo content and autoplay, which drives the components through their public API and real pointer events. The old Canvas 2D ports andweb/engineare gone. - Docs, README, the agent prompt, the skill and the MCP server use
npx dissolve-uiand cover both platforms.
v0.0.4
Added
- Components, shadcn style:
npx react-native-dissolve initinstalls thetwprimitives and theme
tokens,add <name>copies a component's source (and the registry files it imports) into your
project,listshows what is available. Components live inregistry/with anindex.json. - NativeWind v5 theme tokens (
registry/theme.css):--dissolve-*colors for light and dark,
mapped tobg-dissolve-*,text-dissolve-*andborder-dissolve-*utilities, and
useToken()for Skia and Reanimated values. - Automated tests with
node:test(no new dependency): CLI against temp projects, registry
consistency (index, files, imports, exports, colors), theme tokens, engine presets and the npm
package contents. - CI runs the type check, tests and a package build on every push and pull request. A Release
workflow publishes to npm with provenance onv*tags. Dependabot keeps npm packages and
GitHub Actions up to date. - GitHub issue forms (bug, feature, component request), CODEOWNERS and
.nvmrc.
Changed
- The
react-native-dissolvenpm package is engine only: the engine, hooks, CLI and registry.
The app UI components are not bundled, they are installed as source with the CLI. scripts/build-package.shworks with both BSD and GNU sed, so the package builds on Linux CI.
Removed
- The
pilevariant and theusePilehook, with theflooroption and the provider's persistent
layers that only the heap used.
npm: https://www.npmjs.com/package/react-native-dissolve/v/0.0.4
v0.0.3
Website GitHub buttons link to the dissolve repo, the every variant grid plays one tile at a time, CI on Node 22.
npm: https://www.npmjs.com/package/react-native-dissolve/v/0.0.3
v0.0.2
The MCP server ships as its own dependency free package, react-native-dissolve-mcp.
npm: https://www.npmjs.com/package/react-native-dissolve/v/0.0.2
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