wix-cli-extension-registration

Registers Wix CLI extensions with the app builder in src/extensions.ts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @wix/astro.

What problem does it solve? Newly created Wix CLI extensions do not appear in the dashboard, editor, or checkout flows until they are registered in src/extensions.ts, and a missing .use() call is the most common cause of extensions silently failing. ## Core Features & Use Cases - Extension Registration: Import extension builders and chain them with .use() calls in src/extensions.ts so the Wix CLI build system discovers them. - Simple and Advanced Patterns: Register extensions directly for small apps, or re-export all extensions from src/index.ts and register them programmatically for large apps. - Naming and Troubleshooting Guidance: Apply the {extensiontype}{CamelCaseName} export naming convention and diagnose issues like missing imports, wrong paths, and export name mismatches. - Use Case: After generating a new dashboard page extension, add its import and .use(dashboardpageMyPage) call to src/extensions.ts so the page appears in the Wix dashboard sidebar. ## Quick Start Register my new dashboard page extension by adding its import and .use() call to src/extensions.ts.

Frequently Asked Questions about wix-cli-extension-registration

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

FAQPage Schema
How do I register a Wix CLI extension in my app?▼

Import the extension from its extensions.ts file into src/extensions.ts and add a .use(extensionName) call to the app() builder chain. The Wix CLI discovers extensions only through this single entry point.

Why is my Wix extension not appearing in the dashboard?▼

The most common cause is a missing .use() call in src/extensions.ts. Verify the extension is imported, added to the chain, and that its export name matches the import exactly.

What naming convention do Wix extension exports follow?▼

Export names follow the pattern {extensiontype}{CamelCaseName}, such as dashboardpageCartPopupManager or embeddedscriptCouponPopup. The type prefix is the extension type in lowercase with no separators.

Do all Wix extension types require registration in extensions.ts?▼

No. Backend API extensions built as Astro server endpoints are auto-discovered and do not require registration. Dashboard pages, site widgets, embedded scripts, and service plugins all require .use() registration.

How do I register many Wix extensions in a large app?▼

Re-export all extensions from src/index.ts, then import the module namespace in src/extensions.ts and loop over Object.values() calling appBuilder.use() for each extension programmatically.