wix-cli-site-widget

Creates React-based custom element widgets with settings panels for Wix CLI applications.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-cli-site-widget-esssowhat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wix-cli-site-widget
Source: https://github.com/ESSSoWhat/live-translate-realtime-dubbing/tree/main/wix-app/np/.agents/skills/wix-cli-site-widget
Command: npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-cli-site-widget-esssowhat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires react, react-dom, react-to-webcomponent, @wix/editor, @wix/design-system, @wix/data, @wix/site-window, @wix/astro, and includes references (resource) components.

What problem does it solve? Building interactive, configurable widgets for Wix sites requires coordinating React components, web component conversion, editor settings panels, and extension registration, which is error-prone without a structured guide. ## Core Features & Use Cases - Widget Component Generation: Creates widget.tsx files that convert React components to web components using react-to-webcomponent with proper camelCase prop mapping and inline styles. - Settings Panel Construction: Builds panel.tsx files using Wix Design System components with widget.getProp/setProp integration, including native color and font pickers via @wix/editor. - Extension Registration: Generates extensions.ts with unique UUIDs and guides registration in the main src/extensions.ts file so widgets appear in the Wix Editor. - Use Case: A developer asks for a countdown timer widget; the Skill produces the widget component, a settings panel with date/time inputs and color pickers, and the extension registration needed to make it available in the Wix Editor. ## Quick Start Ask the assistant to create a Wix site widget, such as a countdown timer or product showcase, and it will generate the widget component, settings panel, and extension registration files.

Frequently Asked Questions about wix-cli-site-widget

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

FAQPage Schema
How do I create a custom element widget for a Wix site?

Create a widget folder under src/extensions/site/widgets/custom-elements, write a React component in widget.tsx, convert it with reactToWebComponent, add a settings panel in panel.tsx, and register it via extensions.customElement with a unique UUID.

How do I build a settings panel for a Wix widget?

Use Wix Design System components wrapped in WixDesignSystemProvider and SidePanel, then read and write properties with widget.getProp and widget.setProp from @wix/editor. Prop names in the panel API use kebab-case like "bg-color".

Why is my Wix widget not showing up in the editor?

The widget must be registered in two places: an extensions.ts file in the widget folder with a unique static UUID, and the main src/extensions.ts file. Missing the second registration step prevents the widget from appearing in the Wix Editor.

Can I use a color input or text input for color and font pickers in Wix?

No. Use inputs.selectColor from @wix/editor with a FillPreview component for colors, and inputs.selectFont with a Button for fonts. These open the native Wix pickers; HTML color inputs and text inputs do not match the editor experience.

How do I use Wix Data API inside a custom element widget?

Check the view mode with wixWindow.viewMode from @wix/site-window before fetching. In Editor mode, render a placeholder instead of querying collections; only call items.query on the live site to avoid errors.