Publish Your Wallpaper

In this tutorial, you'll build your wallpaper into a distributable package and publish it to the Fluxlay store.

Prerequisites

  • Complete a previous tutorial to have a working wallpaper project.
  • A Fluxlay account with onboarding completed.

Log In

Authenticate with your Fluxlay account:

pnpm fluxlay login

A browser window opens for sign-in. Once approved, your session is saved locally.

Verify you're logged in:

pnpm fluxlay whoami

Build Locally

To test the build without publishing:

pnpm fluxlay build

This produces a wallpaper.fluxlay file — an encrypted, self-contained package. You can specify a custom output name:

pnpm fluxlay build -o my-wallpaper.fluxlay

Publish to the Store

When you're ready to share:

pnpm fluxlay publish

This command:

  1. Validates your fluxlay.yaml (the kind field is required)
  2. Builds the bundle based on kind (Vite build for web; single-file packaging for video / image using source)
  3. Encrypts and packages the content
  4. Uploads to the Fluxlay store
  5. Registers the version

After publishing, your wallpaper will be available on the gallery and can be installed by any Fluxlay user.

Update Metadata

After publishing, you can update the wallpaper's metadata (name, description, tags, preview images) from the dashboard.

Next Steps

Post-publish:

Reference: