skills.rest
thisisjaymehta
thisisjaymehtaCOMMUNITY
Explore all skills by this author →
Website𝕏@thisisjaymehtaGitHub

wix-cli-service-plugin

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building Wix service plugins (SPIs) requires precise handler signatures, response structures, 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 checklist and code patterns for implementing service plugins with provideHandlers() from @wix/ecom/service-plugins and @wix/bookings/service-plugins. - Seven SPI References: Detailed reference docs for Additional Fees, Discount Triggers, Gift Cards, Shipping Rates, Tax Calculation, Validations, and Bookings Staff Sorting, each with imports, handler signatures, and response schemas. - Extension Registration: Enforces the mandatory two-step registration with builder methods, unique UUIDs, and updates to src/extensions.ts. - Use Case: Add a custom handling fee to every checkout by implementing the Additional Fees SPI, registering it with ecomAdditionalFees(), and verifying with npx wix build. ## Quick Start Ask the assistant to create a Wix service plugin for your chosen SPI type, such as custom shipping rates, and have it read the matching reference doc before writing plugin.ts and extensions.ts.

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 objects with code, title, logistics, and cost. Then register it with the ecomShippingRates() builder in extensions.ts using a unique UUID.

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

Implement the Additional Fees SPI by providing a calculateAdditionalFees handler that returns an additionalFees array with code, name, and price as a string. Return an empty array when no fees apply, and register the plugin with the ecomAdditionalFees() builder.

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

Service plugins require two registration steps: a plugin-specific extensions.ts file with the correct builder method and a unique UUID, plus an update to the main src/extensions.ts file. You must also build and release a new version before changes take effect.

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, cart.getCart, or products methods. 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 received in availableResourceIds, 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
yaelbroyaelbro

wix-cli-orchestrator

Orchestrates Wix CLI extension selection, implementation sub-agents, and validation workflows.

Community
Advanced
yaelbroyaelbro

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