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-contextsblogpost-list-item.md

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

Blog context: @wix/blog/context/post-list-item

Read Importing a Context in Code first. Import only the hook, from @wix/blog/context/post-list-item.

PostItemContextProvider

Supplies one blog post, injected per repeater cell, to its children.

import { PostItemContextProvider } from '@wix/blog/context/post-list-item';
  • Parameters: __0: PostItemContextProviderProps
  • Returns: ReactNode

usePostListItemContext

Nullable rather than throwing: the hook runs for every element inside the repeater cell, including on the editor stage before the cell is populated.

import { usePostListItemContext } from '@wix/blog/context/post-list-item';
  • Parameters: none
  • Returns: PostItemContextType \| null
Returned types
PostItemContextProviderProps
Property Type Description
postData PostListItem | undefined The current item of the postsList array, injected by the platform per repeater cell (the Post List manifest's contextImplementor.propKey). Absent on the editor's unbound template cell — the three-way branch below matches the bookings builder's service-context: item → publish it; no item → render children over nulls (the nullable hook is the "null fields"); this provider has no standalone fetch path.
children ReactNode
PostItemContextType
Property Type Description
_id string Post ID.
title string Post's title, as plain text.
itemTitle RichText Post's title, as rich text. Its text field holds the plain text, and its html field holds the text as an HTML paragraph.
itemExcerpt RichText Post's excerpt, as rich text. Empty when the post has no excerpt.
itemCoverImage Image | undefined Post's cover image, with its URL, size, and alt text. For a post whose cover is a video uploaded to Wix, the video's poster image. undefined when there's no image to show, such as when the cover is an embedded video. It holds the cover image even when the post's author hid the cover. To leave out a hidden cover, check itemCoverMedia, which is undefined then.
itemCoverMedia CoverMedia | undefined Post's cover as an image or a playable video. Use it to play a video cover, which itemCoverImage holds only as its poster image. undefined when the post has no cover, or the post's author hid it.
itemLink Link | undefined Link to the post's page. href is the page's URL, and target is '_self', so the link opens in the same tab. undefined when the post has no slug and no URL.
itemPublishedDate RichText Date the post was first published, as rich text in the site's regional format. In the week after publishing, it's relative, such as "3 days ago". After that, it's a date, such as "Aug 5", with the year when it isn't the current year.
publishedDateValue string | undefined Date the post was first published, as an ISO 8601 string. undefined when the post has no publish date.
clockValue number Current time that itemPublishedDate is relative to, in milliseconds since the Unix epoch. When you format publishedDateValue as a relative date yourself, use this value as the current time, so your text matches itemPublishedDate.
minutesToReadValue number | undefined Estimated reading time, in minutes. undefined when the post has no estimate.
initialViewCount number | undefined Number of times the post was viewed, as loaded with the post. undefined when the count wasn't loaded with the post. In the editor, but not in Preview, a sample number instead.
initialCommentCount number | undefined Number of comments on the post, as loaded with the post. undefined when the count wasn't loaded with the post. In the editor, but not in Preview, a sample number instead.
authorName RichText Name of the post's author, as rich text. Empty when the author isn't found.
authorImage Image | undefined Author's profile photo, with its URL, size, and alt text. The alt text is the author's name, or a generic author-photo label when the author has no name. undefined when the author has no photo.
timeToRead RichText Estimated reading time as rich text in the site's language, such as "5 min read". Empty when the post has no estimate.
viewCount RichText Number of views as rich text in the site's language, such as "1,234 views". Empty when the count wasn't loaded with the post. In the editor, but not in Preview, a sample count instead.
commentCount RichText Number of comments as rich text in the site's language. Empty when the count wasn't loaded with the post. In the editor, but not in Preview, a sample count instead.
itemCategoryLabel RichText Name of the post's main category, as rich text. It's the first of the post's categories that still exists. Empty when none of the post's categories exists. In the editor, but not in Preview, a sample name instead.
recentPostItem { title: string; slug: string; } Post's title and slug, as plain text.
commentingEnabled boolean | undefined Whether site visitors can comment on the post. undefined when it isn't known, such as for the sample posts in the editor.
isLiked boolean
isLikeCountLoaded boolean False while the fresh like-count read is in flight (always false on SSR) — the Counters widget renders a skeleton instead of a possibly-stale number until it flips. A skipped read (editor, preview, no post id) and a failed read both settle to true with the baked count, so the skeleton never outlives its fetch.
toggleLike (pointerEvent?: PointerEvent | undefined) => Promise<void>
liveLikes LiveLikes The same like state, live: updated synchronously, while the fields above update in a transition. Stable identity — publish it on the context value as is.
likeCountValue number The raw counters for widgets (Counters reads likeCountValue). Named apart from the bindable richText labels likeCount / viewCount / commentCount, which PostListItem already carries and this provider overrides once the per-cell metadata read resolves.
viewCountValue number | undefined
commentCountValue number | undefined
likeCount RichText
CoverMedia
Property Type Description
kind "image" | "wixVideo" | "embed" Image cover. Cover video uploaded to Wix. Cover video embedded from another site, such as YouTube.

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.