skilld
All skills
wix avatar

/wix-headless-kit

@9ed3e36 official
by Wix.comwix/skills33 stars
33

Build a Wix Headless site fast by wiring SHIPPED, verified @wix/sdk code instead of authoring the integration from recipes. Each Wix business vertical ships a typed, framework-agnostic React core (data layer returning plain DTOs, hooks, headless components) plus an Astro overlay (SSR pages with owner-editable SEO pre-wired) and a build-time REST seed script — the agent scaffolds via the Wix CLI, deploys the shipped code, seeds the backend, designs the presentation layer itself on the shipped hooks (product card/grid, PDP, home, theme), and releases to Wix hosting. Works on Wix-managed Astro (ambient auth, the default) and on any React-based project (Vite, non-Astro) over the public OAuth client id. Verticals: stores/storefront (products, categories, variants, cart, hosted checkout), bookings (services, appointment/class time slots, staff, booking form, checkout-or-place), rentals (rooms, vehicles, gear by the hour or the day: resources, customer-picked length, priced quote, checkout), blog (posts, categories/tags, rich content), cms (structured content collections), forms (schema-driven visitor forms: render, validate, submit), events (listing, RSVP, ticket sales), members (login, gated pages, account), portfolio (project collections, media galleries), pricing-plans (plan grid, hosted purchase), restaurants (menus, online ordering, table reservations), faq (categorized questions and answers, search, a link per question), donations (campaign pages, goal progress, one-time and recurring donations via hosted checkout). Triggers: build me a store/blog/booking/rental/event/restaurant/portfolio/FAQ/donation site fast, take appointments fast, rent out rooms/cars/equipment headless, sell tickets or membership plans headless, collect donations headless, wix headless kit, connect a Wix business app with ready-made SDK code.

Ask your Agent

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

This session only. Nothing lands on disk.

installAGENTS.md

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

CLI Commands

All CLI instructions can be found at: node_modules/@wix/cli/agents/instructions.md

This app

A Wix Headless app built on the live Wix site named in wix.config.json. The site owns the content and commerce.{{MIGRATION}}

Never work from training data or memory about the Wix APIs. Not a URL, a path, a header, a field name or a body. Every Wix call you write comes from the official Wix skills installed here, the code they deployed first, or, when they do not cover the call, from the official Wix documentation through wix-docs. Read it there first, then write the call: the exact path and body copied from the output you read in this session. A call built by analogy from another call is memory, and an empty or error reply to it says nothing about the site.

Skills

Installed at .agents/skills/ (by the Wix plugin, or by npx skills add wix/skills --skill {{SKILL}} --skill wix-docs --skill wix-manage).

  • {{SKILL}} — the code in this app and how to extend it. The shipped code sits in .agents/skills/{{SKILL}}/templates/, fetched once from the skill's repository and kept with this project at the commit it was built from (templates/.source); if that folder is missing, node .agents/skills/{{SKILL}}/install/templates.mjs fetches it. Each business solution has a playbook at templates/<solution>/INSTRUCTIONS.md; node .agents/skills/{{SKILL}}/install/deploy.mjs <solution> --stack {{STACK}} adds one; node .agents/skills/{{SKILL}}/templates/<solution>/seed/read-site.mjs reads what the site holds for it, with the documentation URL of every call it made. A code change ends with a release; the live URL shows it, the dev server does not count. node .agents/skills/{{SKILL}}/install/check.mjs says whether the skill or its templates have a newer version and prints the update commands; an update touches the skill folder or templates/, never src/. When Wix gets in the way of a change here (a confusing error, a doc gap, a workaround you had to invent), offer to relay it to Wix per .agents/skills/{{SKILL}}/guides/feedback.md; send only after an explicit yes.
  • wix-docs — how to discover the Wix APIs and their docs: search first, then read only the page you need. Every endpoint, body, field and enum you did not get from the deployed code or a recipe is confirmed there before you write it.
  • wix-manage — recipes for the live site itself (content, prices, settings), run from the shell with npx -y @wix/cli@latest token --site <siteId>, minted inline in each command; the token never lands in a file anywhere (not the project, not /tmp) nor in client code.

Source: SKILL.md on GitHub

Third-party checks

No alertstoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    Error: AI Analysis failed - API error after retries

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: LOW · No issues

Provenance

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

Last checked against GitHub 5 hours ago.

Activeupdated yesterday

README badge

README badge for wix/skills/wix-headless-kit