mcpField
W
wix-headless-templates

wix-headless-templates

github.com/wix开发36179 次安装今天更新
代码仓库

关于 wix-headless-templates

按业务解决方案分类的 Wix Headless 网站模板集合，供 `wix-headless-kit` 使用。它提供源代码和种子数据材料，由 kit 组合成可部署项目。

主要功能

  1. 01涵盖 13 种 Wix 业务解决方案
  2. 02与框架无关的应用核心
  3. 03带可编辑 SEO 的 Astro 页面
  4. 04基于原生 fetch 的 REST 数据层
  5. 05网站填充与检查脚本
  6. 06组合式项目脚手架

适用场景

  1. 01启动 Wix Headless 商店或博客
  2. 02围绕预约、活动或表单构建网站
  3. 03按方案填充网站并检查现有内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wix/skills --skill wix-headless-templates

安装后在 Claude Code 中输入/wix-headless-templates确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

blank/project/
.gitignore
astro.config.mjs
package.json
README.md
tsconfig.json
blank/project/public/
favicon.svg
blank/project/src/assets/
astro.svg
background.svg
wix.svg
blank/project/src/components/
Hero.astro
Welcome.astro
blank/project/src/layouts/
Layout.astro
blank/project/src/pages/
index.astro
blog/app-astro/layouts/
SiteLayout.astro
blog/app-astro/pages/
blog.astro
blog/app-astro/pages/blog/
[...slug].astro
blog/app-astro/pages/blog/category/
[slug].astro
blog/app-astro/pages/blog/tag/
[slug].astro
blog/app/components/blog/
BlogFeedView.tsx
CommentsView.tsx
PostLikeButton.tsx
PostView.tsx
RichContent.tsx
blog/app/hooks/blog/
useBlogFeed.ts
useComments.ts
usePost.ts
blog/app/wix/blog/
authors-core.ts
authors.ts
blog-feed-store.ts
comments-core.ts

详细介绍

Wix 无头模板

Wix 无头网站的构建代码，每个 Wix Business Solution 对应一个文件夹。wix-headless-kit 是负责执行构建的技能：其 install/templates.mjs 会将此文件夹获取一次，放入工具包自身的 templates/ 中（这是 skills/wix-headless-templates/ 的稀疏克隆，或者是工具包在某个检出目录中运行时使用的检出目录），然后工具包会从中复制、部署并填充内容。此技能本身不包含任何流程；它只是构建所需的材料，以技能的形式保留，便于像技能一样发布、镜像和阅读。

目录结构

路径内容
<solution>/INSTRUCTIONS.md该解决方案的操作手册：包含的内容、每个钩子、存储和 DTO 的契约、页面以及仪表板链接
<solution>/app/与框架无关的核心：wix/<solution>/*-core.ts（纯逻辑）、SDK 传输层、*-store.ts 状态机、types.ts；hooks/（React 绑定）和 components/（参考实现，正确且简洁）
<solution>/app-astro/Astro 页面和布局，预先配置了可由站点所有者编辑的 SEO
<solution>/rest/使用纯 fetch 实现的另一套数据层，导出内容相同，适用于没有打包工具的站点
<solution>/seed/SEED.md（计划的结构和注意事项）、seed-<solution>.mjs（根据计划填充站点，且可幂等执行）、read-site.mjs（报告站点中已有的内容）
<solution>/project/组合后的项目：CLI 的空白脚手架，其中已部署该解决方案并包含 package-lock.json；创建或附加时会整体复制，因此 npm ci 无需解析即可安装
shared/DESIGN.md 和 CONTENT.md（每个站点都必须达到的基本要求）、CUSTOM_OPERATIONS.md（需要提升权限调用的服务端工作）、app/ 和 rest/（客户端、媒体和配置接口）、capabilities/（站点搜索、媒体上传）、seed/（每个 seed 都会用到的 CLI 解析器、令牌、图像解析器和站点上下文）
blank/组合项目所基于的原始 CLI 脚手架
compose.mjs仓库工具：根据 blank/ 和部署内容重建解决方案的 project/，并生成其锁文件

各个解决方案：storefront、bookings、rentals、blog、cms、forms、members、events、 restaurants、donations、pricing-plans、portfolio、faq。

单独阅读

  • 了解解决方案的功能及其各部分的配合方式：先看 <solution>/INSTRUCTIONS.md，再看 app/wix/<solution>/types.ts。
  • 了解如何填充站点以及 seed 会拒绝哪些内容：<solution>/seed/SEED.md。
  • 查看写入任何内容之前现有站点中的内容：node <solution>/seed/read-site.mjs --site <siteId>（需登录 Wix CLI）。
  • 在项目文件夹中手动运行 seed（该文件夹需包含 wix.config.json）：node <solution>/seed/seed-<solution>.mjs plan.json。

修改此内容

app/、app-astro/、rest/ 和 seed/ 下的代码是源代码；在仓库检出目录中运行 node compose.mjs <solution>，即可根据这些代码生成 project/（该命令会重新安装项目依赖，因此类型检查前请在项目中运行 npm ci）。组合后的项目会使用自身的 tsconfig.json 通过 tsc 进行检查。锁文件在本地解析，绝不在沙盒镜像上解析。

评论

支持 Markdown