skills.rest
yaelbro
yaelbroCOMMUNITY
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 Apr 9, 2026
Search Tags:#typescript#backend#spi#checkout#ecommerce#wix#service plugin
One-click install
npx skills add https://github.com/yaelbro/Shelf-Control --skill wix-cli-service-plugin-yaelbro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-cli-service-plugin
Source: https://github.com/yaelbro/Shelf-Control/tree/main/.agents/skills/wix-cli-service-plugin
Command: npx skills add https://github.com/yaelbro/Shelf-Control --skill wix-cli-service-plugin-yaelbro

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. This Skill guides the implementation of custom backend logic for Wix business solutions so plugins compile, register, and respond correctly when Wix calls them. ## Core Features & Use Cases - SPI Implementation Guidance: Step-by-step patterns for Additional Fees, Shipping Rates, Tax Calculation, Validations, Discount Triggers, Gift Cards, and Bookings Staff Sorting plugins using provideHandlers(). - Extension Registration: Enforces the mandatory two-step registration with builder methods like ecomShippingRates() and bookingsStaffSortingProvider(), including unique UUID generation and src/extensions.ts updates. - Schema-First Workflow: Directs reading reference docs and calling ReadFullDocsMethodSchema before writing any code, plus permission elevation with auth.elevate for Wix API calls. - Use Case: A developer needs to add a handling fee to every checkout. The Skill walks them through creating plugin.ts with calculateAdditionalFees, registering it via ecomAdditionalFees(), and verifying with npx wix build. ## Quick Start Ask the assistant to create a Wix service plugin for your scenario, for example: "Create an additional fees service plugin that adds a $5 handling fee to every order."

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 function returning rate options. Then register it with the ecomShippingRates() builder in extensions.ts using a unique UUID, and update src/extensions.ts.

How do I add custom fees to Wix checkout orders?▼

Implement the Additional Fees SPI by providing a calculateAdditionalFees handler that returns fee objects with string prices and a currency. Register the plugin with the ecomAdditionalFees() builder, then release a version and trigger checkout to test.

Why is my Wix service plugin not running after I created it?▼

Service plugins require two registration steps: a plugin-specific extensions.ts file with the correct 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 other Wix APIs like data collections?▼

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 resource IDs it received, only reordered, and must respond within 5 seconds with under 500ms recommended. Invalid responses cause Wix to fall back to random staff assignment.

Related Skills

Explore More Software Engineering Skills→
divinaarmueladivinaarmuela

wix-headless

Configures Wix Headless backends and generates SDK integration guides for frontend applications.

Community
Advanced
ESSSoWhatESSSoWhat

wix-cli-service-plugin

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

Community
Advanced
nirganonnirganon

wix-cli-extension-registration

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

Community
Basic
wixwix
25

wix-cli-service-plugin

Implement Wix SPI service plugins with TypeScript handlers and validation.

Official
Advanced