wix-cli-dashboard-plugin

Creates dashboard plugin widgets that embed into slots on Wix business app dashboard pages.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/nirganon/nir-beauty --skill wix-cli-dashboard-plugin-nirganon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wix-cli-dashboard-plugin
Source: https://github.com/nirganon/nir-beauty/tree/main/.agents/skills/wix-cli-dashboard-plugin
Command: npx skills add https://github.com/nirganon/nir-beauty --skill wix-cli-dashboard-plugin-nirganon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @wix/astro, @wix/design-system, @wix/dashboard, and includes references (resource) components.

What problem does it solve? Building widgets that extend Wix dashboard pages requires knowing exact slot IDs, the dashboardPlugin builder API, and a mandatory two-step extension registration process. This Skill guides the creation of dashboard plugins for Wix first-party business apps (Wix Stores, Bookings, Blog, eCommerce, Events) with correct configuration and registration. ## Core Features & Use Cases - Plugin Scaffolding: Generates the .extension.ts builder file with a unique UUID and the React .tsx component wrapped in WixDesignSystemProvider. - Slot Reference: Provides a complete catalog of slot IDs across Wix Blog, Bookings, eCommerce, Events, Stores, and Restaurants, including typed parameters per slot. - Host Page Integration: Implements observeState() from the Wix Dashboard SDK so plugins receive live data from the host dashboard page. - Use Case: Add a promotional banner plugin to the Wix Blog Posts page by targeting slot 46035d51-2ea9-4128-a216-1dba68664ffe, rendering a Card component, and registering it in src/extensions.ts. ## Quick Start Ask the assistant to create a dashboard plugin for a specific Wix app page, for example: create a plugin on the Wix eCommerce order page that shows fulfillment status.

Frequently Asked Questions about wix-cli-dashboard-plugin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a dashboard plugin for a Wix dashboard page?

Create a folder under src/extensions/dashboard/plugins/ containing an .extension.ts file using extensions.dashboardPlugin() with a unique UUID and slot ID, plus a .tsx React component. Then register the extension in src/extensions.ts or the plugin will not appear.

How do I find the slot ID for a Wix dashboard plugin?

Slot IDs are fixed GUIDs published per Wix business app and page, such as 46035d51-2ea9-4128-a216-1dba68664ffe for the Blog Posts page. Use the exact ID in the extends field; never invent slot IDs.

How does a Wix dashboard plugin receive data from the host page?

Use dashboard.observeState() from the @wix/dashboard SDK inside a useEffect to subscribe to parameters passed by the host page. Some apps like Wix Blog also expose typed parameter interfaces from their dashboard packages.

Why is my Wix dashboard plugin not appearing on the page?

The two common causes are missing registration and a wrong slot ID. Verify the extension is imported and used in src/extensions.ts, and confirm the extends field matches a valid slot ID for the target page.

When should I use a dashboard plugin instead of a dashboard page in Wix CLI?

Use a dashboard plugin to embed a widget into an existing slot on a Wix first-party app page. Use a standalone dashboard page for full custom pages, and site widgets or site plugins for site-facing UI.