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.