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

/wix-headless-templates

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

The shipped, verified code behind Wix Headless sites, one folder per Wix Business Solution: an online store, bookings, rentals, a blog, CMS collections, forms, members, events, restaurants, donations, pricing plans, a portfolio, an FAQ. Each ships a typed framework-agnostic data layer and stores over @wix/sdk, React hooks and reference components, Astro pages with owner-editable SEO, a REST twin for sites without a bundler, a seed script that fills the site from a plan, a reader that reports what a site already holds, and a playbook (INSTRUCTIONS.md) with the contracts. Shared across them: design and content floors, the capabilities (site search, media upload), the seed helpers, and a composed, lock-pinned project per solution that a create copies whole. Used by wix-headless-kit, which fetches, deploys and seeds from this folder; readable on its own to see what a solution's code does and how it is seeded.

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

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

SKILL.md

≈236 tokens for metadata: the name and description. ≈775 when used: this file. ≈1665k more on demand in 125 files.

Description uses 11.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈943 characters, or 11.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Wix Headless Templates

The code a Wix Headless site is built from, one folder per Wix Business Solution. wix-headless-kit is the skill that runs a build: its install/templates.mjs fetches this folder once into the kit's own templates/ (a sparse clone of skills/wix-headless-templates/, or the checkout when the kit runs from one) and the kit copies, deploys and seeds from there. This skill holds no flow of its own; it is the material, kept as a skill so it is published, mirrored and readable like one.

Layout

path what it is
<solution>/INSTRUCTIONS.md the solution's playbook: what ships, the contracts of every hook, store and DTO, the pages, the dashboard links
<solution>/app/ the framework-agnostic core: wix/<solution>/*-core.ts (pure logic), the SDK transport, *-store.ts state machines, types.ts; hooks/ (React bindings) and components/ (reference implementations, correct and plain)
<solution>/app-astro/ Astro pages and layouts with owner-editable SEO pre-wired
<solution>/rest/ the data layer a second time over plain fetch, same exports, for a site with no bundler
<solution>/seed/ SEED.md (the plan shape and the traps), seed-<solution>.mjs (fills the site from a plan, idempotent), read-site.mjs (reports what the site already holds)
<solution>/project/ the composed project: the CLI's blank scaffold with the solution deployed and a package-lock.json, copied whole at create or attach so npm ci installs without resolving
shared/ DESIGN.md and CONTENT.md (the floors every site meets), CUSTOM_OPERATIONS.md (server-side work that needs elevated calls), app/ and rest/ (the client, media and config seams), capabilities/ (site search, media upload), seed/ (the CLI resolver, token, image resolver and site context every seed uses)
blank/ the pristine CLI scaffold the composed projects start from
compose.mjs repository tooling: rebuilds a solution's project/ from blank/ plus a deploy, and its lock

The solutions: storefront, bookings, rentals, blog, cms, forms, members, events, restaurants, donations, pricing-plans, portfolio, faq.

Reading it on its own

  • What a solution does and how its pieces fit: <solution>/INSTRUCTIONS.md, then app/wix/<solution>/types.ts.
  • How a site is filled and what the seed refuses: <solution>/seed/SEED.md.
  • What an existing site holds before anything is written: node <solution>/seed/read-site.mjs --site <siteId> (a logged-in Wix CLI).
  • A seed by hand, from a project folder with a wix.config.json: node <solution>/seed/seed-<solution>.mjs plan.json.

Changing it

Code under app/, app-astro/, rest/ and seed/ is the source; project/ is generated from it with node compose.mjs <solution> from a checkout of the repository (it reinstalls the project's dependencies, so run npm ci in the project before a typecheck). A composed project is checked with tsc on its own tsconfig.json. Locks are resolved locally, never on a sandbox mirror.

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 warnings1d3 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    This skill provides a comprehensive collection of templates and libraries for building headless websites on the Wix platform. The code adheres to security best practices, utilizing official Wix SDKs and providing clear documentation on maintaining security boundaries between client and server operations.

  • Socket1d

    2 alerts: gptAnomaly

  • Snyk1d

    Risk: unknown · No issues

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 2 months ago

README badge

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