skills.rest
nirganon
nirganonCOMMUNITY
Explore all skills by this author →
GitHub

wix-cli-service-plugin

Implements Wix service plugin extensions that inject custom backend logic into eCommerce and Bookings flows.

Updated Mar 30, 2026
Search Tags:#typescript#backend#spi#checkout#ecommerce#wix#service plugin
One-click install
npx skills add https://github.com/nirganon/nir-beauty --skill wix-cli-service-plugin-nirganon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-cli-service-plugin
Source: https://github.com/nirganon/nir-beauty/tree/main/.agents/skills/wix-cli-service-plugin
Command: npx skills add https://github.com/nirganon/nir-beauty --skill wix-cli-service-plugin-nirganon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building Wix service plugins (SPIs) requires exact handler signatures, response schemas, and a two-step extension registration process that is easy to get wrong, causing plugins to silently fail or never activate. ## Core Features & Use Cases - SPI Implementation Guidance: Step-by-step patterns for seven SPI types including shipping rates, additional fees, tax calculation, validations, discount triggers, gift cards, and bookings staff sorting. - Reference Documentation: Per-SPI references with correct imports, handler signatures, working TypeScript examples, and links to fetch exact request/response schemas. - Extension Registration: Enforces the mandatory two-step registration with builder methods, unique UUIDs, and updates to the main extensions file. - Use Case: A developer needs to add a custom handling fee at checkout; the Skill guides them to create plugin.ts with provideHandlers(), register it via extensions.ecomAdditionalFees(), and verify with tsc and wix build. ## Quick Start Ask the AI to create a Wix service plugin for custom shipping rates and follow the checklist to implement, register, and build the extension.

Frequently Asked Questions about wix-cli-service-plugin

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

FAQPage Schema
How do I create a Wix service plugin for custom shipping rates?▼

Create a plugin.ts file that imports shippingRates from @wix/ecom/service-plugins and calls provideHandlers() with a getShippingRates handler returning rate options. Then register it with extensions.ecomShippingRates() using a unique UUID and add it to src/extensions.ts.

How to add custom fees at Wix checkout with a service plugin?▼

Implement the additionalFees service plugin with a calculateAdditionalFees handler that returns fee objects with string prices and a currency. Register it using the ecomAdditionalFees() builder method, then build and release the project for it to take effect.

Why is my Wix service plugin not running after implementation?▼

Service plugins require two registration steps: a plugin-specific extensions.ts file with a builder method and an update to the main src/extensions.ts file. Changes also only take effect after you build and release a new version of the project.

Can Wix service plugins call Wix APIs like data queries?▼

Yes, but you must elevate permissions using auth.elevate from @wix/essentials before calling APIs such as items.query or cart.getCart. Without elevation, the calls lack the required permissions inside the plugin context.

What are the limitations of the Bookings staff sorting plugin?▼

The sortStaffMembers handler must return the exact same IDs from availableResourceIds, only reordered, and must respond within 5 seconds. Invalid responses cause Wix to fall back to random staff assignment.

Related Skills

Explore More Software Engineering Skills→
divinaarmueladivinaarmuela

wix-app

Builds and validates Wix CLI app extensions across dashboard, backend, and site surfaces.

Community
Advanced
biggorabiggora
1

wix-ecommerce

Design and implement Wix eCommerce apps, extensions, widgets, and Blocks.

Community
Intermediate
thenslsthensls

gws

Control Google Workspace services from the CLI with OAuth authentication.

Official
Advanced
Prismer-AIPrismer-AI
1.4k

Prismer Cloud — Agent Skill

Coordinate Prismer agents' knowledge across web content, documents, and cross-agent signals.

Official
Advanced