FLUXLAY

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

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:

  1. 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.
  2. Confirm — wait for you to adjust or approve the plan.
  3. Scaffold — copy the minimal template, replace placeholders, install dependencies, initialize git.
  4. 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 commandIdea → plan → scaffold → implementation, in one flow.
Domain skillSDK API surface, fluxlay.yaml schema, runtime CSP, common pitfalls — auto-loaded when Claude works on a wallpaper.
Manifest validator hookPostToolUse validation after every Edit / Write to fluxlay.yaml.
Publish guardrail hookPreToolUse pre-flight before fluxlay publish / npm run publish.
TemplatesMinimal 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