CLI Commands

fluxlay login

Authenticate with your Fluxlay account via device authorization.

fluxlay login

Opens a browser window for sign-in. Displays a user code for verification. The session is saved locally after approval.

fluxlay logout

Remove the saved session.

fluxlay logout

fluxlay whoami

Display the currently authenticated user.

fluxlay whoami

fluxlay dev

Start a development server for live wallpaper preview.

fluxlay dev [dir]

Behavior:

1. Validates fluxlay.yaml.
2. Finds an available port starting from 3000.
3. Starts a Vite dev server.
4. Writes dev.json to the app data directory.
5. The desktop app detects the dev server and renders with HMR.

fluxlay build

Build the wallpaper into an encrypted .fluxlay package.

fluxlay build [dir] [-o <name>]

Requires: Active login session and a kind field in fluxlay.yaml.

Behavior branches by kind:

• kind: web → Runs Vite build and packages dist/.
• kind: video / kind: image → Packages the single media file specified by source.

fluxlay publish

Build and publish the wallpaper to the Fluxlay store.

fluxlay publish [dir]

Requires: Active login session, completed onboarding.

Behavior:

1. Validates fluxlay.yaml (the kind field is required).
2. Generates a content encryption key.
3. Registers the version with the API.
4. Builds the bundle based on kind:
   • web: Packages the Vite build output (dist/).
   • video / image: Packages the media file specified by source as media.<ext> (Vite build is skipped).
5. Encrypts and uploads.
6. Confirms with the API.

For kind: video / kind: image wallpapers, HTML is not bundled — the desktop app generates it dynamically at delivery time.