Index of every page on this site: llms.txt
All skills
wix avatar

/wix-app

@e2bc48e official
by Wix.comwix/skills40 stars
42
Run it yourself

Build and review Wix CLI app extensions — dashboard pages, modals, plugins, menu plugins, custom element widgets, Editor React components, site plugins, embedded scripts, context providers, function libraries, lightbox (popup) behavior, page onLoad contexts, backend APIs, backend events, service plugins, data collections, and App Market readiness. Use when building ANY feature or extension for a Wix CLI app or preparing a Wix app for App Market review. Triggers on: add, build, create, implement, help me, dashboard, widget, plugin, backend, API, event, collection, embedded script, service plugin, Editor React component, context provider, function library, onLoad, on page load, checkout, shipping, tax, discount, SPI, CMS, schema, tracking, popup, lightbox, admin panel, menu item, modal, validate, test, verify, register extension, App Market, app review, submission readiness.

Use this Skill: https://skilld.dev/gh/wix/skills/wix-app

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencescontext-providervertical-contextsbookingsservice-2.md

≈2.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Bookings context: @wix/bookings/context/service (part 2 of 5)

This context's reference is split across 5 files: service.md, service-2.md, service-3.md, service-4.md, service-5.md.

Read Importing a Context in Code first. Import only the hook, from @wix/bookings/context/service.

Service$1
Property Type Description
_id string | null | undefined Service ID.
appId string | null | undefined ID of the app associated with the service. You can't update appId. Services are displayed in Wix Bookings only if they are associated with the Wix Bookings appId or have no associated app ID. Default: 13d21c63-b5ec-5912-8397-c3a5ddb27a97 (Wix Bookings app ID) For services from Wix apps, the following values apply: - Wix Bookings: "13d21c63-b5ec-5912-8397-c3a5ddb27a97" - Wix Services: "cc552162-24a4-45e0-9695-230c4931ef40" - Wix Meetings: "6646a75c-2027-4f49-976c-58f3d713ed0f".<!-- [Scheduling Form Fields](https://dev.wix.com/docs/api-reference/business-solutions/bookings/about-scheduling-form-fields) services also use this app ID. Use `createdByAppId` to distinguish between Wix Meetings and Scheduling Form Fields services.--> Full list of apps created by Wix. <!-- TODO: Uncomment when Platform docs are published - Learn more about [app identity in the Bookings Platform](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings-platform/app-identity-in-the-bookings-platform). -->
createdByAppId string | null | undefined ID of the app that created the service. This field is used for analytics, auditing, and tracking creation sources. This read-only field is automatically populated during service creation by checking these sources in order: 1. The caller's App ID from the request identity context. 2. The service's appId field. 3. The Wix Bookings App ID (13d21c63-b5ec-5912-8397-c3a5ddb27a97) as the final fallback. <!-- TODO: Uncomment when Platform docs are published - Learn more about [app identity in the Bookings Platform](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings-platform/app-identity-in-the-bookings-platform). -->
type ServiceTypeWithLiterals | undefined Service type. Learn more about service types.
sortOrder number | null | undefined Order of the service within a category.
name string | null | undefined Service name.
description string | null | undefined Service description. For example, High-class hair styling, cuts, straightening and color.
tagLine string | null | undefined Short service description, such as Hair styling.
defaultCapacity number | null | undefined Default maximum number of customers that can book the service. The service cannot be booked beyond this capacity.
media Media | undefined Media associated with the service.
hidden boolean | null | undefined Whether the service is hidden from Wix Bookings pages and widgets.
category V2Category | undefined Category the service is associated with. Services aren't automatically assigned to a category. Without an associated category, the service isn't visible on the live site.
form Form | undefined Form the customer filled out when booking the service.
payment Payment | undefined Payment options for booking the service. Learn more about service payments.
onlineBooking OnlineBooking | undefined Online booking settings.
conferencing Conferencing | undefined Conferencing options for the service.
locations V2Location[] | undefined The locations this service is offered at. Read more about service locations.
bookingPolicy BookingPolicy | undefined Policy determining under what conditions this service can be booked. For example, whether the service can only be booked up to 30 minutes before it begins.
schedule Schedule | undefined The service's schedule, which can be used to manage the service's events.
staffMemberIds string[] | undefined IDs of the resources associated with the staff members providing the service. Note that these are the resource IDs, not the staff member IDs. For appointment-based services, set this field when creating or updating the service. For classes and courses, this field is read-only and is automatically derived from staff assigned to the service's recurring scheduled sessions. Staff assigned only to single, non-recurring events are not included. Once all of a staff member's upcoming recurring sessions have ended, their ID is removed from this field. To retrieve the full list of staff for classes or courses, query the service's calendar events instead. Learn more about retrieving staff for classes and courses.
staffMemberDetails StaffMemberDetails | undefined Staff members details. Returned only if STAFF_MEMBER_DETAILS conditional field was specified.
serviceResources ServiceResource[] | undefined Information about which resources must be available so customers can book the service. For example, a meeting room or equipment. Some nested fields are only returned when specific conditional fields are requested: pass RESOURCE_TYPE_DETAILS to retrieve resourceType.name, and RESOURCE_DETAILS to retrieve resourceDetails.resources.
supportedSlugs Slug[] | undefined A slug is the last part of the URL address that serves as a unique identifier of the service. The list of supported slugs includes past service names for backwards compatibility, and a custom slug if one was set by the business owner.
mainSlug Slug | undefined Active slug for the service. Learn more about service slugs.
urls URLs | undefined URLs to various service-related pages, such as the calendar page and the booking page.
extendedFields ExtendedFields$1 | undefined Extensions enabling users to save custom data related to the service.
seoData SeoSchema | undefined Custom SEO data for the service.
_createdDate Date | null | undefined Date and time the service was created in YYYY-MM-DDThh:mm:ss.sssZ format.
_updatedDate Date | null | undefined Date and time the service was updated in YYYY-MM-DDThh:mm:ss.sssZ format.
revision string | null | undefined Revision number, which increments by 1 each time the service is updated. To prevent conflicting changes, the existing revision must be used when updating a service.
addOnGroups AddOnGroup[] | undefined Information about the add-on groups associated with the service.
addOnDetails AddOnDetails[] | undefined Details about all add-ons customers can choose when booking the service.
taxableAddress TaxableAddress | undefined Taxable address used to calculate tax
primaryResourceType string | null | undefined ID of the resource type that serves as the primary resource for this appointment service. The primary resource type determines which resources drive slot assignment and availability resolution. For example, when set to a "Meeting Rooms" resource type, availability is calculated based on the rooms' schedules rather than staff schedules. Default: The staff resource type.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

2 warningstoday4 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides a comprehensive environment and set of tools for building Wix CLI app extensions. It includes detailed instructions, API references, and local utility scripts for development tasks like SDK lookup and accessibility auditing. All operations and dependencies are standard for the Wix developer platform.

  • Sockettoday

    1 alert: gptAnomaly

  • Snyktoday

    Risk: MEDIUM · 1 issue

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at e2bc48e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 6 days ago
compatibility
requires `@wix/cli` >= 1.1.192.

README badge

README badge for wix/skills/wix-app

Builds dashboard pages, modals, plugins, custom widgets, Editor React components, backend APIs, events, service plugins, and data collections for Wix CLI apps. Provides decision logic, API patterns, and validation workflows; scaffolding is owned by the Wix CLI via `wix generate --params`.

Generated from the current SKILL.md.

What extension types does this skill cover?
All Wix CLI app extension types: dashboard pages, modals, plugins, menu plugins, custom element widgets, Editor React components, site plugins, embedded scripts, backend APIs, backend events, service plugins, and data collections.
Does this skill scaffold the extension files for me?
The Wix CLI owns scaffolding via `wix generate --params` for all extension types except Backend API. This skill provides decision logic, API guidance, and business-logic patterns to fill in the generated stubs. Backend API files must be created manually.
What Wix CLI version is required?
The skill requires @wix/cli >= 1.1.192.
Do I need to create a Data Collection extension for app-specific data?
Yes, if you're saving or persisting app-specific data, managing domain entities in a dashboard, or running a service plugin that reads app-configured data. The skill infers this automatically—you don't need to explicitly request it.
Does this skill cover Wix Stores API usage?
Yes. When using any Wix Stores API (products, inventory, orders), the skill requires dual V1/V3 catalog support and references the Stores Versioning guide for module selection and field mapping.

Generated from the current SKILL.md. These answers refresh after source changes.