1. Pick a surface
Wallpaper, widget, app, cursor set, or icon set. Each one has a small manifest and a clear runtime contract.
ODD bundles are small, inspectable files that plug into WP Desktop Mode: living wallpapers, widgets, sandboxed apps, pointer wardrobes, and native icon sets.
manifest.json
scene.js
wallpaper.webp
card.webp
Declare the surface, ship the assets, return a cleanup function, and let Desktop Mode own the chrome.
Wallpaper, widget, app, cursor set, or icon set. Each one has a small manifest and a clear runtime contract.
Use Desktop Mode hooks for windows, widgets, commands, and icons. ODD adds content; Desktop Mode keeps control of the system.
Run the catalog builder to produce a .wp bundle with preview art, hashes, and a store row that ODD can verify.
Canvas or Pixi scenes that return a synchronous teardown and clean up every ticker, listener, and texture.
Small desktop companions that use the host widget APIs and leave drag, resize, and close behavior to Desktop Mode.
Sandboxed windows with their own HTML, CSS, and JS, loaded through ODD's iframe bridge and cookie-auth serve path.
Raster PNG or WebP icon feeds for the native Desktop Mode icon pipeline. No DOM swapping, no rail rewrites.
Pointer assets and optional live cursor effects, confined to current-user preferences and Desktop Mode surfaces.
Use the host hooks, inherit the theme, validate your bundle, and return cleanup handles. The best ODD extensions feel like Desktop Mode grew a new room.