Build with Claude Code

The fastest way to build a Fluxlay wallpaper today is to let Claude Code do the work. Our official plugin bundles everything needed: a scaffolder, a domain skill that knows the SDK / manifest / CSP rules, and guardrail hooks that block bad publishes.

💡 Prefer the manual path? Skip to Getting Started — it walks through the same project layout step by step.

Prerequisites

Claude Code
Fluxlay desktop app installed
Node.js v20 or later (any package manager: npm / pnpm / yarn / bun)

Install the plugin

In Claude Code, run:

/plugin marketplace add fluxlay/claude-plugin
/plugin install fluxlay@fluxlay

That's it. The plugin is now active in every Claude Code session.

Create a wallpaper

Just describe what you want to build:

/fluxlay:new a breathing circle whose color tracks CPU usage

Claude will:

Plan — propose the kind (web / video / image), slug, SDK hooks (e.g. useSystemMonitor), required permissions: / network: declarations, and any CSP gotchas relevant to your idea.
Confirm — wait for you to adjust or approve the plan.
Scaffold — copy the minimal template, replace placeholders, install dependencies, initialize git.
Implement — write src/main.tsx using the SDK hooks identified during planning.

For a video or image wallpaper, just say so — Claude picks the right template, sets kind: and source:, and tells you where to drop the media file.

Develop, build, publish — in conversation

Once the project exists, talk to Claude in natural language:

"Start the dev server" — runs the dev script (the desktop app must be running for HMR preview)
"Build and check it works under production CSP" — runs the build script
"Publish it" — kicks off publish, but the bundled PreToolUse hook intercepts first and runs pre-flight checks (build freshness, manifest validity, fluxlay whoami login state). Hard failures are blocked; otherwise you get a confirmation summary.

Edits to fluxlay.yaml are also validated automatically by a PostToolUse hook — slug format, SemVer, kind enum, source extension. Errors are surfaced back to Claude so they get fixed in the same turn.

What the plugin includes


`/fluxlay:new` command	Idea → plan → scaffold → implementation, in one flow.
Domain skill	SDK API surface, `fluxlay.yaml` schema, runtime CSP, common pitfalls — auto-loaded when Claude works on a wallpaper.
Manifest validator hook	`PostToolUse` validation after every `Edit` / `Write` to `fluxlay.yaml`.
Publish guardrail hook	`PreToolUse` pre-flight before `fluxlay publish` / `npm run publish`.
Templates	Minimal scaffolds for `web` (Vite + React) and `video` / `image` (single media file).

Updating the plugin

Claude Code marketplaces update on demand:

/plugin marketplace update

Run this periodically to pick up the latest plugin version.

Source & feedback

The plugin is open source: github.com/fluxlay/claude-plugin. Issues, ideas, and contributions are welcome.

Next steps

Interactive Wallpaper — Add SDK hooks for mouse / keyboard / system data.
Publish Your Wallpaper — Walk through the full publish flow manually.
Manifest Reference — Every field, every type.