fluid—wallpaper

fluid-wallpaper / Contribute

Your current.
Our collection.

Turn an experiment into a starting point for everyone.

Explore the galleryBuild with fluid-hero ↗

Make something worth getting lost in. Share it so someone else can build on it.

01. Find your composition

Start in the gallery or tuner. Explore colors, material contrast, point emitters, wind and slow drivers. Choose a solid, gradient or transparent background. Gallery contributions must work without external video, audio capture, camera or tilt.

02. Export a full preset

In the tuner’s Presets tab, save a named preset and export its JSON. Keep the existing fluid-wallpaper.preset.v1 format. A contribution contains exactly one preset, with a stable lowercase slug and matching name in its metadata.

03. Add your folder

presets/your-preset/
  preset.json     # exported full configuration
  metadata.json   # description and attribution
  preview.png     # captured from the actual field
{
  "id": "your-preset",
  "name": "Your Preset",
  "description": "Describe its color and motion.",
  "character": "Soft / luminous / slow",
  "accent": "#7aefdc",
  "author": "Your public name",
  "license": "MIT",
  "tags": ["soft", "luminous", "slow"]
}

Set the exported preset’s ID to the folder slug and its name to the metadata name. Keep its numeric updatedAt timestamp. Preserve material IDs and emitter/binding references. Unknown fields and silently clamped values are rejected; export using the current tuner.

04. Capture and check

Capture the actual field without editor chrome as a 640 × 400 PNG preview. Do not use a rendered mockup that differs from the preset. Preview images are source artwork for the gallery, not part of the npm runtime. 

yarn test
yarn build

Both commands validate the discovered collection. Check the gallery at desktop and mobile widths, try ECO, and inspect the composition after it has evolved. Include browser/device details with performance observations; do not claim a guaranteed FPS.

05. Open a pull request

Include the preset folder, a short explanation of its palette and motion, validation results, and any known visual limitations. The catalog discovers new folders automatically. Submit only original work you can contribute under MIT; use a public attribution name and do not include private URLs or credentials.

Review checks visual distinction, reference integrity, useful defaults, no required external media, readable metadata, and a representative preview. Experimental two-liquid scenes have a different contract and are not accepted into this established-renderer collection.

Open a contribution on GitHub ↗