Home

ODD Developer Wiki

ODD — Outlandish Desktop Decorator is the catalog, Shop, and decoration layer for WP Desktop Mode. It adds living wallpapers, raster icon sets, cursor effects, desktop widgets, and tiny apps while relying on Desktop Mode's native windows, dock, taskbar, files, widget layer, and settings contracts.

The canonical source lives in the main repo docs. This wiki mirrors the release-facing docs so contributor notes, WordPress.org packaging, and public support links stay in one place.

Start Here

• Architecture — plugin map, native Desktop Mode contract, REST surface, catalog model, and security boundaries.
• Building on ODD — extension points, SDK, event bus, lifecycle, and registry contracts for companion plugins.
• Store State Machine — Shop card states, recovery paths, and trust labels.
• Desktop Mode Boundaries and Desktop Mode Hook Coverage — what ODD owns, what the host owns, and which host hooks ODD uses.

Authoring

• Building an App
• Building a Scene
• Building an Icon Set
• Building a Cursor Set
• Building a Widget
• WP Manifest Reference
• Shareable Workspaces

Release And Safety

• Release Policy — versioning rules, catalog-only updates, API cadence, and release semantics.
• Releasing — local validation, GitHub release, WP.org/SVN, Playground smoke, and wiki sync.
• Serve Paths Security — authenticated app serving, static asset paths, REST capability model, and raw-byte exceptions.
• API Versioning — public JS/API compatibility rules.
• Gotchas — old lessons that should not be relearned the hard way.

Current Baseline

• ODD plugin release: 1.1.3
• WordPress: 6.8+
• PHP: 8.1+
• WP Desktop Mode runtime floor: 0.8.5+
• Public Playground host pin: WP Desktop Mode 0.8.6