wix-cli-extension-registration

Register Wix CLI extensions in src/extensions.ts using import and use patterns.

25|31|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/wix/skills --skill wix-cli-extension-registration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wix-cli-extension-registration
Source: https://github.com/wix/skills/tree/main/wix-cli/skills/wix-cli-extension-registration
Command: npx skills add https://github.com/wix/skills --skill wix-cli-extension-registration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After creating any extension file, you MUST update the main src/extensions.ts file to register the extension with the app. Without this step, the extension will not be recognized by Wix CLI.

Core Features & Use Cases

  • Simple Pattern: Import the extension from its extensions.ts and chain .use(extensionName) in the app builder.
  • Advanced Pattern: Re-export all extensions from a central index file and programmatically register them with the app builder.
  • Naming conventions and guidance: Follow the provided examples to ensure consistent extension export names.

Quick Start

Add or update your extension file and register it in src/extensions.ts by adding app().use(yourExtension).

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 Wix CLI extensions in my app builder?

To register Wix CLI extensions, import the extension in src/extensions.ts and chain .use(extensionName) on your app builder instance. This explicit registration step wires the extension into the main app builder.

Why is my Wix CLI extension not being recognized by the app?

Wix CLI extensions are not recognized when they are not registered in src/extensions.ts. You must update this file by adding app().use(yourExtension) after creating any extension file for the app builder to recognize it.

What is the advanced pattern for registering multiple Wix CLI extensions?

The advanced pattern for registering multiple Wix CLI extensions involves re-exporting all extensions from a central index file and programmatically registering them with the app builder in src/extensions.ts, ensuring explicit registration and consistent naming conventions.

Do I need to update extensions.ts every time I add a new Wix CLI extension?

Yes, you must update the main src/extensions.ts file every time you add a new Wix CLI extension. Without this explicit registration step using import and use patterns, the extension will not be recognized by the app builder.

What naming conventions should I follow when registering Wix CLI extensions?

When registering Wix CLI extensions, follow the provided examples in src/extensions.ts to ensure consistent extension export names. Explicit registration through simple or advanced patterns enforces these recommended practices.

Can I programmatically register Wix CLI extensions instead of chaining use methods?

Yes, you can programmatically register Wix CLI extensions using the advanced pattern. Re-export all extensions from a central index file and programmatically register them with the app builder in src/extensions.ts.