# Fluxlay — Full Documentation Index > Expanded llms.txt with every documentation page and its description. For the curated overview see /llms.txt. ## About Fluxlay Fluxlay is a platform for creating, sharing, and discovering high-quality live wallpapers for macOS and Windows desktops. There are two creation paths: 1. **No-code (Creator)**: Upload an image or video through the desktop app and publish it as a wallpaper. 2. **Developer (React SDK)**: Build interactive wallpapers with React, TypeScript, and the @fluxlay/react SDK, then publish them via the CLI. The marketplace supports both free and paid wallpapers. Paid wallpapers are processed through Stripe Connect; creators receive payouts to their connected accounts. ## Stack - Desktop app: Tauri 2 (Rust + React) for macOS and Windows 11 - Web (this site): TanStack Start + React 19 + Cloudflare Workers - API: Go + ConnectRPC (Clean Architecture) - DB / auth: Supabase - Storage / CDN: storage.fluxlay.com on Cloudflare - Payments: Stripe + Stripe Connect ## Creator Documentation - Upload an Image Wallpaper — https://fluxlay.com/en/studio/creator/how-to/create/upload-image-wallpaper.md Publish an image wallpaper directly from the desktop app's Upload screen. - Release a New Version — https://fluxlay.com/en/studio/creator/how-to/manage/release-new-version.md Swap the image or video of an existing wallpaper and ship it as a new version. - Install the Desktop App — https://fluxlay.com/en/studio/creator/how-to/setup/install-app.md Download, install, and sign in to the Fluxlay desktop app. - Supported File Formats — https://fluxlay.com/en/studio/creator/reference/file-formats.md Image and video file formats accepted by the desktop app's upload screen. - Publish Your First Image Wallpaper — https://fluxlay.com/en/studio/creator/tutorials/first-image-wallpaper.md Upload an image straight from the Fluxlay desktop app and publish it to the store. - Upload a Video Wallpaper — https://fluxlay.com/en/studio/creator/how-to/create/upload-video-wallpaper.md Publish a video wallpaper directly from the desktop app's Upload screen. - Edit Your Listing (Name, Description, Previews) — https://fluxlay.com/en/studio/creator/how-to/manage/edit-listing.md Update an existing wallpaper's title, description, tags, or preview images without re-publishing. - Field Rules — https://fluxlay.com/en/studio/creator/reference/field-rules.md Validation rules for the Slug / Name / Version / Tags fields on the upload screen. - Publish Your First Video Wallpaper — https://fluxlay.com/en/studio/creator/tutorials/first-video-wallpaper.md Upload a video file from the Fluxlay desktop app and publish it as a wallpaper. ## Developer Documentation - Build with Claude Code — https://fluxlay.com/en/studio/developer/tutorials/with-claude-code.md Use the official Fluxlay Claude Code plugin to scaffold, develop, and publish a wallpaper from a single prompt. - Run the Dev Server — https://fluxlay.com/en/studio/developer/how-to/development/dev-server.md Start the development server for live wallpaper preview. - Build a Wallpaper — https://fluxlay.com/en/studio/developer/how-to/publishing/build.md Build your wallpaper into a distributable .fluxlay package. - Install the Desktop App — https://fluxlay.com/en/studio/developer/how-to/setup/install-app.md Download and install the Fluxlay desktop app. - CLI Commands — https://fluxlay.com/en/studio/developer/reference/cli/commands.md Reference for all Fluxlay CLI commands. - useMousePosition — https://fluxlay.com/en/studio/developer/reference/sdk/use-mouse-position.md API reference for the useMousePosition hook. - Vite Plugin — https://fluxlay.com/en/studio/developer/reference/vite-plugin.md Reference for the @fluxlay/vite plugin. - Getting Started — https://fluxlay.com/en/studio/developer/tutorials/getting-started.md Create your first Fluxlay wallpaper from scratch and preview it on your desktop. - Custom Properties — https://fluxlay.com/en/studio/developer/how-to/development/use-properties.md Let users customize your wallpaper with custom properties. - Publish a Wallpaper — https://fluxlay.com/en/studio/developer/how-to/publishing/publish.md Publish your wallpaper to the Fluxlay store. - Install the CLI — https://fluxlay.com/en/studio/developer/how-to/setup/install-cli.md Set up the Fluxlay CLI for developing and publishing wallpapers. - Manifest (fluxlay.yaml) — https://fluxlay.com/en/studio/developer/reference/cli/manifest.md Schema reference for the fluxlay.yaml manifest file. - useProperties — https://fluxlay.com/en/studio/developer/reference/sdk/use-properties.md API reference for the useProperties hook. - Interactive Wallpaper — https://fluxlay.com/en/studio/developer/tutorials/interactive-wallpaper.md Build a wallpaper that reacts to mouse movement using the SDK. - Track Mouse Position — https://fluxlay.com/en/studio/developer/how-to/development/use-mouse-position.md Access global mouse position in your wallpaper. - Update Metadata — https://fluxlay.com/en/studio/developer/how-to/publishing/update-metadata.md Update your wallpaper's name, description, tags, and preview images. - Create a Project — https://fluxlay.com/en/studio/developer/how-to/setup/create-project.md Set up a new Fluxlay wallpaper project from scratch. - useAudio — https://fluxlay.com/en/studio/developer/reference/sdk/use-audio.md API reference for the useAudio hook. - Shell Wallpaper — https://fluxlay.com/en/studio/developer/tutorials/shell-wallpaper.md Create a wallpaper that displays live system information using shell commands. - React to Audio — https://fluxlay.com/en/studio/developer/how-to/development/use-audio.md Build a music-reactive wallpaper from system audio volume and spectrum. - Create a Video Wallpaper — https://fluxlay.com/en/studio/developer/how-to/setup/create-video-wallpaper.md Build a kind: video wallpaper from a single video file. - useMediaMetadata — https://fluxlay.com/en/studio/developer/reference/sdk/use-media-metadata.md API reference for the useMediaMetadata hook. - Publish Your Wallpaper — https://fluxlay.com/en/studio/developer/tutorials/publish-wallpaper.md Build and publish your wallpaper to the Fluxlay store. - Display Now Playing Media — https://fluxlay.com/en/studio/developer/how-to/development/use-media-metadata.md Show the currently playing track from Spotify, Apple Music, and other system players. - Create an Image Wallpaper — https://fluxlay.com/en/studio/developer/how-to/setup/create-image-wallpaper.md Build a kind: image wallpaper from a single image file. - useSystemMonitor — https://fluxlay.com/en/studio/developer/reference/sdk/use-system-monitor.md API reference for the useSystemMonitor hook. - Display System Stats — https://fluxlay.com/en/studio/developer/how-to/development/use-system-monitor.md Render live CPU, memory, and battery stats in your wallpaper. - useShell — https://fluxlay.com/en/studio/developer/reference/sdk/use-shell.md API reference for the useShell hook. - Run Shell Commands — https://fluxlay.com/en/studio/developer/how-to/development/use-shell.md Execute shell commands and display their output in your wallpaper. - runShell — https://fluxlay.com/en/studio/developer/reference/sdk/run-shell.md API reference for the runShell function. - Run Shell Commands Imperatively — https://fluxlay.com/en/studio/developer/how-to/development/run-shell.md Use runShell to execute a command on demand instead of on an interval. - useTerminal — https://fluxlay.com/en/studio/developer/reference/sdk/use-terminal.md API reference for the useTerminal hook. - Display Terminal Output — https://fluxlay.com/en/studio/developer/how-to/development/use-terminal.md Embed a styled terminal emulator in your wallpaper. - Terminal Themes — https://fluxlay.com/en/studio/developer/reference/sdk/terminal-themes.md List of all built-in terminal color themes. - Customize Terminal Theme — https://fluxlay.com/en/studio/developer/how-to/development/customize-theme.md Change the color theme of the embedded terminal. - useMouseEvents — https://fluxlay.com/en/studio/developer/reference/sdk/use-mouse-events.md API reference for the useMouseEvents hook. - Mimo: Interactive UI inside Wallpapers — https://fluxlay.com/en/studio/developer/how-to/development/mimo.md Use Mimo via @fluxlay/react/mimo to make ordinary React UI interactive inside a wallpaper window. - useKeyboard — https://fluxlay.com/en/studio/developer/reference/sdk/use-keyboard.md API reference for the useKeyboard hook. - Fetch External APIs (CORS workaround) — https://fluxlay.com/en/studio/developer/how-to/development/fetch-external-api.md How to call external HTTP APIs from a wallpaper, including a workaround for endpoints that don't return CORS headers. - getPropertyFileUrl — https://fluxlay.com/en/studio/developer/reference/sdk/get-property-file-url.md API reference for the getPropertyFileUrl helper. - useImeInput — https://fluxlay.com/en/studio/developer/reference/sdk/use-ime-input.md API reference for the useImeInput hook. - useIsFocused — https://fluxlay.com/en/studio/developer/reference/sdk/use-is-focused.md API reference for the useIsFocused hook. - useActiveElement — https://fluxlay.com/en/studio/developer/reference/sdk/use-active-element.md API reference for the useActiveElement hook. - MimoProvider — https://fluxlay.com/en/studio/developer/reference/sdk/mimo-provider.md API reference for MimoProvider, the input forwarder bundled with the Fluxlay SDK. - proxiedFetch — https://fluxlay.com/en/studio/developer/reference/sdk/proxied-fetch.md API reference for the proxiedFetch helper that routes external HTTP requests through the Fluxlay host. - openUrl — https://fluxlay.com/en/studio/developer/reference/sdk/open-url.md API reference for the openUrl helper that opens a URL in the user's default browser. - notify — https://fluxlay.com/en/studio/developer/reference/sdk/notify.md API reference for the notify helper that posts an OS-level notification. ## Other resources - Gallery: https://fluxlay.com/en/gallery - Download for macOS: https://storage.fluxlay.com/releases/darwin/universal/latest.dmg - Download for Windows: https://storage.fluxlay.com/releases/windows/x86_64/latest.exe - New wallpapers RSS: https://fluxlay.com/feed.xml - Sitemap: https://fluxlay.com/sitemap.xml - Terms of Service: https://fluxlay.com/en/legal/terms - Privacy Policy: https://fluxlay.com/en/legal/privacy