create-weapp-vite 2.7.3 → 2.8.0

package/README.md

@@ -7,7 +7,7 @@
 ## 特性
 
 - 交互式创建或非交互式参数创建
-- 内置多种模板（默认、Wevu、Wevu + TDesign、Tailwindcss、TDesign、Vant、插件、组件库）
+- 内置多种模板（默认、原生多平台 + Web、Vue SFC 多平台 + Web、Wevu、Wevu + TDesign、Tailwindcss、TDesign、Vant、插件、组件库）
 - 自动对齐 `weapp-vite` 与 `wevu` 版本
 - 自动处理 `.gitignore` 写入
 - 可选安装推荐的 AI skills（`sonofmagic/skills`）
@@ -45,6 +45,12 @@ npx skills add sonofmagic/skills
 ```bash
 pnpm create weapp-vite my-app wevu
 
+# 原生多平台 + Web 模板
+pnpm create weapp-vite my-app multi-platform
+
+# Vue SFC 多平台 + Web 模板
+pnpm create weapp-vite my-app multi-platform-sfc
+
 # 显式安装推荐 skills
 pnpm create weapp-vite my-app wevu --install-skills
 
@@ -66,7 +72,10 @@ await createProject('my-app', TemplateName.wevu, { installSkills: true })
 `TemplateName` 支持以下模板：
 
 - `default`
+- `multi-platform`
+- `multi-platform-sfc`
 - `wevu`
+- `react`
 - `wevu-tdesign`
 - `tailwindcss`
 - `tdesign`
@@ -74,6 +83,10 @@ await createProject('my-app', TemplateName.wevu, { installSkills: true })
 - `plugin`
 - `lib`
 
+`multi-platform` 使用原生 Page/Component，覆盖微信、支付宝、抖音、百度、京东、小红书与 Web Runtime。它按命令构建单个目标，不会隐式生成全部平台产物；创建后请使用 `dev:<platform>` / `build:<platform>` 脚本。
+
+`multi-platform-sfc` 使用 Wevu + Vue SFC 覆盖相同目标，并提供 `defineAppJson` / `definePageJson` / `defineComponentJson`、受管类型文件和稳定响应式交互示例。Web Runtime 用于浏览器联调，不能替代目标小程序 IDE 或真机验收。
+
 ## 相关链接
 
 - weapp-vite 文档：https://vite.icebreaker.top/

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { n as RECOMMENDED_SKILLS_INSTALL_COMMAND, t as createProject } from "./src-oq4dsVyY.js";
+import { n as RECOMMENDED_SKILLS_INSTALL_COMMAND, t as createProject } from "./src-C3T0ngLd.js";
 import logger from "@weapp-core/logger";
 import { fs } from "@weapp-core/shared/fs";
 import process from "node:process";
@@ -12,6 +12,14 @@ const TEMPLATE_CHOICES = [
 		name: "默认模板",
 		value: "default"
 	},
+	{
+		name: "原生多平台 + Web 模板",
+		value: "multi-platform"
+	},
+	{
+		name: "Vue SFC 多平台 + Web 模板",
+		value: "multi-platform-sfc"
+	},
 	{
 		name: "Wevu 模板 (Vue SFC)",
 		value: "wevu"

package/dist/index.d.ts

@@ -2,6 +2,8 @@ import "pkg-types";
 //#region src/enums.d.ts
 declare enum TemplateName {
   default = "default",
+  multiPlatform = "multi-platform",
+  multiPlatformSfc = "multi-platform-sfc",
   plugin = "plugin",
   wevu = "wevu",
   tailwindcss = "tailwindcss",

package/dist/index.js

@@ -1,2 +1,2 @@
-import { r as TemplateName, t as createProject } from "./src-oq4dsVyY.js";
+import { r as TemplateName, t as createProject } from "./src-C3T0ngLd.js";
 export { TemplateName, createProject };

package/dist/{src-oq4dsVyY.js → src-C3T0ngLd.js}

@@ -9,17 +9,19 @@ import process from "node:process";
 var version$3 = "0.2.0";
 //#endregion
 //#region ../../packages-runtime/wevu/package.json
-var version$2 = "6.20.3";
+var version$2 = "6.20.4";
 //#endregion
 //#region ../dashboard/package.json
-var version$1 = "6.20.3";
+var version$1 = "6.20.4";
 //#endregion
 //#region ../weapp-vite/package.json
-var version = "6.20.3";
+var version = "6.20.4";
 //#endregion
 //#region src/enums.ts
 let TemplateName = /* @__PURE__ */ function(TemplateName) {
 	TemplateName["default"] = "default";
+	TemplateName["multiPlatform"] = "multi-platform";
+	TemplateName["multiPlatformSfc"] = "multi-platform-sfc";
 	TemplateName["plugin"] = "plugin";
 	TemplateName["wevu"] = "wevu";
 	TemplateName["tailwindcss"] = "tailwindcss";
@@ -33,14 +35,24 @@ let TemplateName = /* @__PURE__ */ function(TemplateName) {
 //#endregion
 //#region src/agents.ts
 function supportsWevu(templateName) {
-	return ["wevu", "wevu-tdesign"].includes(templateName);
+	return [
+		"wevu",
+		"wevu-tdesign",
+		"multi-platform-sfc"
+	].includes(templateName);
+}
+function supportsReact(templateName) {
+	return templateName === "react";
 }
 function supportsNativePages(templateName) {
-	return !supportsWevu(templateName);
+	return !supportsWevu(templateName) && !supportsReact(templateName);
 }
 function supportsPlugin(templateName) {
 	return templateName === "plugin";
 }
+function supportsMultiPlatform(templateName) {
+	return ["multi-platform", "multi-platform-sfc"].includes(templateName);
+}
 /**
 * @description 生成新项目的 AGENTS 指引
 */
@@ -95,13 +107,15 @@ function createAgentsGuidelines(templateName) {
 		"- In Codex/Claude environments, prefer these skills first when available:",
 		"  - `$weapp-vite-best-practices` for config, build, subpackage, route, DevTools CLI orchestration, and screenshot/compare command work.",
 		"  - `$weapp-vite-vue-sfc-best-practices` for `.vue` SFC macros, JSON blocks, and template compatibility.",
-		"  - `$release-and-changeset-best-practices` for issue delivery, changesets, release decisions, and PR workflow.",
+		"  - `$release-and-changeset-best-practices` for issue delivery, pnpm change intents, repoctl release decisions, and PR workflow.",
 		"  - `$docs-and-website-sync` when documentation or AI guidance must be refreshed together with code changes.",
 		"  - Use `$weapp-vite-best-practices` for stateful HMR, pluginRoot/dist-plugin, Web runtime compatibility, and native AST profiling; use `$wevu-best-practices` for `wevu/router` navigation semantics.",
 		"  - Use `$weapp-devtools-e2e-best-practices` for serialized DevTools runtime suites, shared automator sessions, and known host compatibility skips."
 	];
 	if (supportsWevu(templateName)) lines.push("  - `$wevu-best-practices` for `wevu` runtime lifecycle, state, store, and event contracts.", "", "## Wevu Authoring", "", "- Import runtime APIs from `wevu` in business code.", "- Register lifecycle hooks synchronously in `setup()` and avoid hook registration after `await`.", "- Prefer `ref`, `reactive`, `computed`, and explicit event contracts over large opaque state writes.", "- Use `storeToRefs` when destructuring store state/getters.", "- Treat mini-program runtime constraints as primary; do not assume Vue web-only behavior.");
+	if (supportsReact(templateName)) lines.push("  - `$weapp-vite-react-best-practices` for React 19 JSX/TSX ownership, render modes, root lifecycle, React Compiler, and native/Wevu component bridges.", "", "## React Mini-program Authoring", "", "- Keep `weapp.react` as the project-level owner for all `.jsx` and `.tsx` modules; do not mix Wevu JSX in the same build.", "- Use React 19.2.x, `react-reconciler` 0.33.x, and `@weapp-vite/react` without `react-dom`.", "- Start with `renderMode: 'auto'`; use `dynamic` only for reconciler-tree diagnostics and `static` for strict static-shape validation.", "- Create and unmount `createReactMiniProgramRoot` in the native page/component lifecycle, and forward host events through the root.", "- Register native or Wevu custom components in `usingComponents` before declaring a top-level `createNativeComponent()` bridge in the current TSX file.", "- Treat the current React runtime as WeChat-only; Web, Alipay, and Douyin builds are not runtime compatibility evidence.");
 	if (supportsNativePages(templateName)) lines.push("  - `$native-to-weapp-vite-wevu-migration` when migrating native mini-program projects to `weapp-vite + native`, or further toward Vue SFC / wevu.", "", "## Native Mini-program Authoring", "", "- Keep native page/component structure consistent with the template unless there is a clear migration goal.", "- Prefer `weapp-vite generate` or `wv generate` for new app/page/component scaffolds.", "- If migrating this project, first decide whether the target is `weapp-vite + native` or a further Vue SFC / `wevu` migration, then keep each migration wave explicit.");
+	if (supportsMultiPlatform(templateName)) lines.push("", "## Multi-platform Workflow", "", "- This project builds one target at a time. Always pass an explicit platform or use `pnpm dev:<platform>` / `pnpm build:<platform>`.", "- Keep platform IDE configuration under `config/<platform>` and import `dist/<platform>` into the matching mini-program IDE.", "- Use `pnpm dev:web` for browser compatibility work, but keep mini-program DevTools or device acceptance as the release authority.", "- Treat WeChat, Web, official IDE compilation, and unsupported automator targets as separate verification layers; do not report a build-only check as runtime E2E.");
 	if (supportsPlugin(templateName)) lines.push("", "## Plugin Authoring", "", "- Keep `src/` as the host app source and `plugin/` as the plugin source root declared by `weapp.pluginRoot`.", "- Validate both `dist/` and `dist-plugin/` outputs after structural changes to host pages, plugin pages, or plugin public components.", "- If you change plugin AppID or switch away from local `dev` linkage, update both `project.config.json.appid` and `src/app.json` -> `plugins.*.provider` together.", "- Treat shared modules under `shared/` as regular source code that can be imported by both host and plugin entries.");
 	return `${lines.join("\n")}\n`;
 }
@@ -406,6 +420,8 @@ const TOURIST_APP_ID = "touristappid";
 const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 const TEMPLATE_DIR_MAP = {
 	["default"]: "weapp-vite-template",
+	["multi-platform"]: "weapp-vite-multi-platform-template",
+	["multi-platform-sfc"]: "weapp-vite-multi-platform-sfc-template",
 	["plugin"]: "weapp-vite-plugin-template",
 	["lib"]: "weapp-vite-lib-template",
 	["wevu"]: "weapp-vite-wevu-template",
@@ -485,12 +501,14 @@ async function ensureDotGitignore(root) {
 	await fs.move(gitignorePath, dotGitignorePath);
 }
 async function rewriteProjectConfigAppId(targetDir) {
-	const projectConfigPath = path.resolve(targetDir, "project.config.json");
-	if (!await fs.pathExists(projectConfigPath)) return;
-	const projectConfig = await fs.readJSON(projectConfigPath);
-	if (!projectConfig || typeof projectConfig !== "object" || projectConfig.compileType === "plugin" || projectConfig.appid === TOURIST_APP_ID) return;
-	projectConfig.appid = TOURIST_APP_ID;
-	await writeJsonFile(projectConfigPath, projectConfig);
+	const projectConfigPaths = [path.resolve(targetDir, "project.config.json"), path.resolve(targetDir, "config/weapp/project.config.json")];
+	for (const projectConfigPath of projectConfigPaths) {
+		if (!await fs.pathExists(projectConfigPath)) continue;
+		const projectConfig = await fs.readJSON(projectConfigPath);
+		if (!projectConfig || typeof projectConfig !== "object" || projectConfig.compileType === "plugin" || projectConfig.appid === TOURIST_APP_ID) continue;
+		projectConfig.appid = TOURIST_APP_ID;
+		await writeJsonFile(projectConfigPath, projectConfig);
+	}
 }
 function createEmptyPackageJson() {
 	return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-weapp-vite",
   "type": "module",
-  "version": "2.7.3",
+  "version": "2.8.0",
   "description": "create-weapp-vite",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -50,8 +50,8 @@
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.1",
     "@weapp-core/init": "6.0.14",
-    "@weapp-core/logger": "3.1.1",
-    "@weapp-core/shared": "3.1.1"
+    "@weapp-core/shared": "3.1.1",
+    "@weapp-core/logger": "3.1.1"
   },
   "scripts": {
     "catalog:sync": "node --import tsx scripts/generate-template-catalog.ts",

package/templates/multi-platform/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true

package/templates/multi-platform/README.md

@@ -0,0 +1,46 @@
+# weapp-vite 原生多平台 + Web 模板
+
+这个模板使用同一份原生小程序源码，按命令选择单个目标平台构建。当前覆盖微信、支付宝、抖音、百度、京东、小红书和 Web Runtime。
+
+```sh
+pnpm create weapp-vite my-app multi-platform
+cd my-app
+pnpm install
+pnpm dev:weapp
+```
+
+## 开发
+
+```sh
+pnpm dev:weapp
+pnpm dev:alipay
+pnpm dev:tt
+pnpm dev:swan
+pnpm dev:jd
+pnpm dev:xhs
+pnpm dev:web
+```
+
+`pnpm dev` 默认等价于 `pnpm dev:weapp`。需要打开开发者工具时使用 `pnpm dev:open`、`pnpm open:weapp` 或 `pnpm open:alipay`。
+
+## 构建
+
+```sh
+pnpm build:weapp
+pnpm build:alipay
+pnpm build:tt
+pnpm build:swan
+pnpm build:jd
+pnpm build:xhs
+pnpm build:web
+```
+
+每条命令只构建一个目标。小程序产物位于 `dist/<platform>/dist`，对应的 IDE 项目位于 `dist/<platform>`；Web 产物位于 `dist/web`。
+
+## 平台配置
+
+各平台项目配置位于 `config/<platform>`。创建项目后请先替换目标平台的 AppID，再导入对应的 `dist/<platform>` 目录。
+
+便携源码使用原生 `Page()` / `Component()`，公共模板采用 WXML 语法，并通过 `wx` API 编写平台无关逻辑。构建时 `injectWeapi.replaceWx` 会替换运行时 API，模板、样式、事件和脚本模块后缀会按目标平台转换。平台专属能力应隔离在独立模块或条件入口中，避免让公共页面直接依赖某个宿主的 TypeScript 类型。
+
+Web Runtime 适合浏览器联调和兼容验证，不能替代小程序开发者工具或真机验收。构建通过也不等于官方 IDE 编译或 Runtime 交互通过：微信和 Web 可以做自动化交互验收，支付宝使用官方 `minidev build` 做 IDE 编译检查，百度 Runtime 依赖可用的 WebSocket 端点，抖音、京东和小红书仍需在各自官方工具中人工复验。详细说明见 [多平台构建指南](https://vite.icebreaker.top/guide/multi-platform)。

package/templates/multi-platform/config/alipay/mini.project.json

@@ -0,0 +1,8 @@
+{
+  "format": 2,
+  "compileType": "mini",
+  "miniprogramRoot": "dist",
+  "compileOptions": {
+    "typescript": false
+  }
+}

package/templates/multi-platform/config/jd/project.config.json

@@ -0,0 +1,4 @@
+{
+  "appid": "your_appid",
+  "miniprogramRoot": "dist"
+}

package/templates/multi-platform/config/swan/project.swan.json

@@ -0,0 +1,8 @@
+{
+  "smartProgramRoot": "dist",
+  "appid": "your_appid",
+  "compileType": "miniprogram",
+  "setting": {
+    "urlCheck": true
+  }
+}

package/templates/multi-platform/config/tt/project.config.json

@@ -0,0 +1,10 @@
+{
+  "appid": "your_appid",
+  "projectname": "weapp-vite-multi-platform-template",
+  "miniprogramRoot": "dist",
+  "setting": {
+    "es6": true,
+    "urlCheck": false,
+    "compileHotReLoad": false
+  }
+}

package/templates/multi-platform/config/weapp/project.config.json

@@ -0,0 +1,23 @@
+{
+  "description": "weapp-vite 多平台模板",
+  "miniprogramRoot": "dist",
+  "srcMiniprogramRoot": "dist",
+  "compileType": "miniprogram",
+  "setting": {
+    "babelSetting": {
+      "ignore": [],
+      "disablePlugins": [],
+      "outputPath": ""
+    },
+    "postcss": false,
+    "minified": false,
+    "ignoreUploadUnusedFiles": true,
+    "compileHotReLoad": false,
+    "packNpmManually": true,
+    "es6": true
+  },
+  "simulatorType": "wechat",
+  "libVersion": "3.13.2",
+  "condition": {},
+  "appid": "wxb3d842a4a7e3440d"
+}

package/templates/multi-platform/config/xhs/project.config.json

@@ -0,0 +1,10 @@
+{
+  "description": "weapp-vite 多平台模板",
+  "miniprogramRoot": "dist",
+  "compileType": "miniprogram",
+  "setting": {
+    "es6": true,
+    "compileHotReload": false
+  },
+  "appid": "your_appid"
+}

package/templates/multi-platform/eslint.config.js

@@ -0,0 +1,6 @@
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+  ignores: ['CHANGELOG.md', 'README.md', '.turbo/**', 'dist/**', '.weapp-vite/**'],
+})

package/templates/multi-platform/gitignore

@@ -0,0 +1,30 @@
+# dependencies
+node_modules
+.pnp
+.pnp.js
+
+# testing
+coverage
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# turbo
+.turbo
+
+dist
+vite.config.ts.timestamp-*.mjs
+.weapp-vite/

package/templates/multi-platform/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" href="data:," />
+    <title>weapp-vite 多平台模板</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/@weapp-vite/web/entry"></script>
+  </body>
+</html>

package/templates/multi-platform/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "weapp-vite-multi-platform-template",
+  "type": "module",
+  "version": "1.0.0",
+  "private": true,
+  "description": "weapp-vite 原生多平台与 Web 模板",
+  "license": "MIT",
+  "scripts": {
+    "dev": "wv dev -p weapp",
+    "dev:weapp": "wv dev -p weapp",
+    "dev:alipay": "wv dev -p alipay",
+    "dev:tt": "wv dev -p tt",
+    "dev:swan": "wv dev -p swan",
+    "dev:jd": "wv dev -p jd",
+    "dev:xhs": "wv dev -p xhs",
+    "dev:web": "wv dev -p web --host",
+    "dev:open": "wv dev -p weapp -o",
+    "build": "wv build -p weapp",
+    "build:weapp": "wv build -p weapp",
+    "build:alipay": "wv build -p alipay",
+    "build:tt": "wv build -p tt",
+    "build:swan": "wv build -p swan",
+    "build:jd": "wv build -p jd",
+    "build:xhs": "wv build -p xhs",
+    "build:web": "wv build -p web",
+    "open:weapp": "wv open -p weapp",
+    "open:alipay": "wv open -p alipay",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "stylelint": "stylelint \"src/**/*.{css,scss,vue,wxss}\" --allow-empty-input",
+    "stylelint:fix": "stylelint \"src/**/*.{css,scss,vue,wxss}\" --fix --allow-empty-input",
+    "g": "wv generate",
+    "postinstall": "wv prepare -p weapp"
+  },
+  "devDependencies": {
+    "@icebreakers/eslint-config": "catalog:",
+    "@icebreakers/stylelint-config": "catalog:",
+    "@types/node": "catalog:",
+    "@weapp-vite/dashboard": "workspace:*",
+    "eslint": "catalog:",
+    "miniprogram-api-typings": "catalog:",
+    "sass": "catalog:",
+    "stylelint": "catalog:",
+    "typescript": "catalog:",
+    "weapp-vite": "workspace:*"
+  }
+}

package/templates/multi-platform/src/app.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://vite.icebreaker.top/app.json",
+  "pages": [
+    "pages/index/index"
+  ],
+  "window": {
+    "navigationBarTitleText": "多平台模板",
+    "navigationBarBackgroundColor": "#ffffff",
+    "navigationBarTextStyle": "black",
+    "backgroundColor": "#f4f6f8"
+  },
+  "sitemapLocation": "sitemap.json"
+}

package/templates/multi-platform/src/app.scss

@@ -0,0 +1,5 @@
+page {
+  min-height: 100%;
+  color: #17212b;
+  background: #f4f6f8;
+}

package/templates/multi-platform/src/app.ts

@@ -0,0 +1,3 @@
+App({
+  globalData: {},
+})

package/templates/multi-platform/src/components/PlatformCard/index.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://vite.icebreaker.top/component.json",
+  "component": true,
+  "styleIsolation": "apply-shared"
+}

package/templates/multi-platform/src/components/PlatformCard/index.scss

@@ -0,0 +1,25 @@
+.platform-card {
+  padding: 32rpx;
+  background: #fff;
+  border: 2rpx solid #d8dee4;
+  border-radius: 12rpx;
+}
+
+.platform-card__label {
+  font-size: 24rpx;
+  color: #66717d;
+}
+
+.platform-card__value {
+  margin-top: 10rpx;
+  font-size: 44rpx;
+  font-weight: 700;
+  color: #0969da;
+}
+
+.platform-card__hint {
+  margin-top: 18rpx;
+  font-size: 26rpx;
+  line-height: 1.6;
+  color: #3d4852;
+}

package/templates/multi-platform/src/components/PlatformCard/index.ts

@@ -0,0 +1,8 @@
+Component({
+  properties: {
+    platform: {
+      type: String,
+      value: 'unknown',
+    },
+  },
+})

package/templates/multi-platform/src/components/PlatformCard/index.wxml

@@ -0,0 +1,5 @@
+<view class="platform-card">
+  <view class="platform-card__label">当前构建目标</view>
+  <view class="platform-card__value">{{platform}}</view>
+  <view class="platform-card__hint">同一份原生源码由 weapp-vite 转换为目标平台产物</view>
+</view>

package/templates/multi-platform/src/pages/index/index.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://vite.icebreaker.top/page.json",
+  "navigationBarTitleText": "多平台模板",
+  "usingComponents": {
+    "PlatformCard": "/components/PlatformCard/index"
+  }
+}

package/templates/multi-platform/src/pages/index/index.scss

@@ -0,0 +1,72 @@
+.page-shell {
+  box-sizing: border-box;
+  min-height: 100vh;
+  padding: 72rpx 32rpx 48rpx;
+}
+
+.page-heading {
+  margin-bottom: 32rpx;
+}
+
+.page-heading__eyebrow {
+  font-size: 24rpx;
+  font-weight: 600;
+  color: #1a7f37;
+}
+
+.page-heading__title {
+  margin-top: 12rpx;
+  font-size: 52rpx;
+  font-weight: 700;
+  color: #17212b;
+}
+
+.page-heading__description {
+  margin-top: 16rpx;
+  font-size: 28rpx;
+  line-height: 1.6;
+  color: #57606a;
+}
+
+.runtime-marker,
+.runtime-status {
+  font-family: monospace;
+  font-size: 24rpx;
+  color: #57606a;
+}
+
+.runtime-status {
+  margin: 8rpx 0 28rpx;
+}
+
+.counter-panel {
+  padding: 32rpx;
+  margin-top: 24rpx;
+  text-align: center;
+  background: #fff;
+  border: 2rpx solid #d8dee4;
+  border-radius: 12rpx;
+}
+
+.counter-panel__label {
+  font-size: 26rpx;
+  color: #57606a;
+}
+
+.counter-panel__value {
+  margin: 18rpx 0;
+  font-size: 64rpx;
+  font-weight: 700;
+  color: #17212b;
+}
+
+.counter-panel__button {
+  width: 100%;
+  color: #fff;
+  background: #1f883d;
+  border-radius: 8rpx;
+}
+
+.counter-panel__button::after {
+  border: 0;
+}

package/templates/multi-platform/src/pages/index/index.ts

@@ -0,0 +1,12 @@
+Page({
+  data: {
+    platform: import.meta.env.PLATFORM,
+    status: 'ready',
+    count: 0,
+  },
+  increment() {
+    this.setData({
+      count: this.data.count + 1,
+    })
+  },
+})

package/templates/multi-platform/src/pages/index/index.wxml

@@ -0,0 +1,22 @@
+<wxs module="platformTools" src="./platform.wxs" />
+
+<view class="page-shell">
+  <view class="page-heading">
+    <view class="page-heading__eyebrow">weapp-vite</view>
+    <view class="page-heading__title">原生多平台 + Web</view>
+    <view class="page-heading__description">一次维护，按目标平台独立构建和验收。</view>
+  </view>
+
+  <view id="platform-marker" class="runtime-marker">MP_PLATFORM={{platformTools.label(platform)}}</view>
+  <view id="runtime-status" class="runtime-status">status={{status}}</view>
+
+  <PlatformCard platform="{{platform}}" />
+
+  <view class="counter-panel">
+    <view class="counter-panel__label">跨端交互检查</view>
+    <view id="counter-value" class="counter-panel__value">{{count}}</view>
+    <button id="increment-button" class="counter-panel__button" bind:tap="increment">
+      增加计数
+    </button>
+  </view>
+</view>

package/templates/multi-platform/src/pages/index/platform.wxs

@@ -0,0 +1,7 @@
+function label(value) {
+  return value || 'unknown'
+}
+
+module.exports = {
+  label: label,
+}

package/templates/multi-platform/src/sitemap.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://vite.icebreaker.top/sitemap.json",
+  "rules": [
+    {
+      "action": "allow",
+      "page": "*"
+    }
+  ]
+}

package/templates/multi-platform/stylelint.config.js

@@ -0,0 +1,5 @@
+import { icebreaker } from '@icebreakers/stylelint-config'
+
+export default icebreaker({
+  miniProgram: true,
+})

package/templates/multi-platform/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "references": [
+    {
+      "path": "./.weapp-vite/tsconfig.app.json"
+    },
+    {
+      "path": "./.weapp-vite/tsconfig.server.json"
+    },
+    {
+      "path": "./.weapp-vite/tsconfig.node.json"
+    },
+    {
+      "path": "./.weapp-vite/tsconfig.shared.json"
+    }
+  ],
+  "files": []
+}

package/templates/multi-platform/vite.config.ts

@@ -0,0 +1,43 @@
+import { defineConfig } from 'weapp-vite'
+
+export default defineConfig({
+  weapp: {
+    srcRoot: 'src',
+    multiPlatform: {
+      enabled: true,
+      targets: ['weapp', 'alipay', 'tt', 'swan', 'jd', 'xhs'],
+    },
+    injectWeapi: {
+      enabled: true,
+      replaceWx: true,
+    },
+    web: {
+      enable: true,
+      outDir: 'dist/web',
+      pluginOptions: {
+        runtime: {
+          routing: {
+            mode: 'history',
+          },
+        },
+      },
+    },
+    generate: {
+      extensions: {
+        js: 'ts',
+        wxss: 'scss',
+      },
+      dirs: {
+        component: 'src/components',
+        page: 'src/pages',
+      },
+    },
+  },
+  css: {
+    preprocessorOptions: {
+      scss: {
+        silenceDeprecations: ['legacy-js-api', 'import'],
+      },
+    },
+  },
+})

package/templates/multi-platform-sfc/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true

package/templates/multi-platform-sfc/README.md

@@ -0,0 +1,43 @@
+# weapp-vite 多平台 Vue SFC + Web 模板
+
+这个模板使用 Wevu 和 Vue SFC 编写 App、Page 与 Component，并按命令选择单个目标平台构建。当前覆盖微信、支付宝、抖音、百度、京东、小红书和 Web Runtime。
+
+```sh
+pnpm create weapp-vite my-app multi-platform-sfc
+cd my-app
+pnpm install
+pnpm dev:weapp
+```
+
+## 开发与构建
+
+```sh
+pnpm dev:weapp
+pnpm dev:alipay
+pnpm dev:tt
+pnpm dev:swan
+pnpm dev:jd
+pnpm dev:xhs
+pnpm dev:web
+
+pnpm build:weapp
+pnpm build:alipay
+pnpm build:tt
+pnpm build:swan
+pnpm build:jd
+pnpm build:xhs
+pnpm build:web
+```
+
+每条命令只构建一个目标。小程序产物位于 `dist/<platform>/dist`，对应的 IDE 项目位于 `dist/<platform>`；Web 产物位于 `dist/web`。
+
+## SFC 约束
+
+- Runtime API 从 `wevu` 导入，页面和组件默认使用 `<script setup lang="ts">`。
+- App、Page、Component 分别使用 `defineAppJson`、`definePageJson`、`defineComponentJson`，一个 SFC 不混用多套 JSON 配置。
+- 公共模板使用显式 props 与事件，不使用 `v-bind="object"`、不可赋值的 `v-model` 或仅适用于 Vue Web 的模板行为。
+- `.weapp-vite` 是 `wv prepare` 管理的类型支持目录；类型漂移时先运行 `pnpm exec wv prepare -p weapp`。
+
+各平台项目配置位于 `config/<platform>`。创建项目后请替换目标平台的 AppID，再导入对应的 `dist/<platform>` 目录。
+
+Web Runtime 适合浏览器联调和兼容验证，不能替代小程序开发者工具或真机验收。微信和 Web 可以做自动化交互验收，支付宝使用官方 `minidev build` 做 IDE 编译检查，百度 Runtime 依赖可用的 WebSocket 端点，抖音、京东和小红书仍需在各自官方工具中人工复验。详细说明见 [多平台构建指南](https://vite.icebreaker.top/guide/multi-platform)。

package/templates/multi-platform-sfc/config/alipay/mini.project.json

@@ -0,0 +1,8 @@
+{
+  "format": 2,
+  "compileType": "mini",
+  "miniprogramRoot": "dist",
+  "compileOptions": {
+    "typescript": false
+  }
+}

package/templates/multi-platform-sfc/config/jd/project.config.json

@@ -0,0 +1,4 @@
+{
+  "appid": "your_appid",
+  "miniprogramRoot": "dist"
+}

package/templates/multi-platform-sfc/config/swan/project.swan.json

@@ -0,0 +1,8 @@
+{
+  "smartProgramRoot": "dist",
+  "appid": "your_appid",
+  "compileType": "miniprogram",
+  "setting": {
+    "urlCheck": true
+  }
+}

package/templates/multi-platform-sfc/config/tt/project.config.json

@@ -0,0 +1,10 @@
+{
+  "appid": "your_appid",
+  "projectname": "weapp-vite-multi-platform-sfc-template",
+  "miniprogramRoot": "dist",
+  "setting": {
+    "es6": true,
+    "urlCheck": false,
+    "compileHotReLoad": false
+  }
+}

package/templates/multi-platform-sfc/config/weapp/project.config.json

@@ -0,0 +1,23 @@
+{
+  "description": "weapp-vite 多平台 SFC 模板",
+  "miniprogramRoot": "dist",
+  "srcMiniprogramRoot": "dist",
+  "compileType": "miniprogram",
+  "setting": {
+    "babelSetting": {
+      "ignore": [],
+      "disablePlugins": [],
+      "outputPath": ""
+    },
+    "postcss": false,
+    "minified": false,
+    "ignoreUploadUnusedFiles": true,
+    "compileHotReLoad": false,
+    "packNpmManually": true,
+    "es6": true
+  },
+  "simulatorType": "wechat",
+  "libVersion": "3.13.2",
+  "condition": {},
+  "appid": "wxb3d842a4a7e3440d"
+}

package/templates/multi-platform-sfc/config/xhs/project.config.json

@@ -0,0 +1,10 @@
+{
+  "description": "weapp-vite 多平台 SFC 模板",
+  "miniprogramRoot": "dist",
+  "compileType": "miniprogram",
+  "setting": {
+    "es6": true,
+    "compileHotReload": false
+  },
+  "appid": "your_appid"
+}

package/templates/multi-platform-sfc/eslint.config.js

@@ -0,0 +1,7 @@
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+  vue: true,
+  ignores: ['CHANGELOG.md', 'README.md', '.turbo/**', 'dist/**', '.weapp-vite/**'],
+})

package/templates/multi-platform-sfc/gitignore

@@ -0,0 +1,30 @@
+# dependencies
+node_modules
+.pnp
+.pnp.js
+
+# testing
+coverage
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# turbo
+.turbo
+
+dist
+vite.config.ts.timestamp-*.mjs
+.weapp-vite/

package/templates/multi-platform-sfc/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" href="data:," />
+    <title>weapp-vite 多平台 SFC 模板</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/@weapp-vite/web/entry"></script>
+  </body>
+</html>

package/templates/multi-platform-sfc/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "weapp-vite-multi-platform-sfc-template",
+  "type": "module",
+  "version": "1.0.0",
+  "private": true,
+  "description": "weapp-vite + Wevu 多平台 Vue SFC 与 Web 模板",
+  "license": "MIT",
+  "scripts": {
+    "dev": "wv dev -p weapp",
+    "dev:weapp": "wv dev -p weapp",
+    "dev:alipay": "wv dev -p alipay",
+    "dev:tt": "wv dev -p tt",
+    "dev:swan": "wv dev -p swan",
+    "dev:jd": "wv dev -p jd",
+    "dev:xhs": "wv dev -p xhs",
+    "dev:web": "wv dev -p web --host",
+    "dev:open": "wv dev -p weapp -o",
+    "build": "wv build -p weapp",
+    "build:weapp": "wv build -p weapp",
+    "build:alipay": "wv build -p alipay",
+    "build:tt": "wv build -p tt",
+    "build:swan": "wv build -p swan",
+    "build:jd": "wv build -p jd",
+    "build:xhs": "wv build -p xhs",
+    "build:web": "wv build -p web",
+    "open:weapp": "wv open -p weapp",
+    "open:alipay": "wv open -p alipay",
+    "typecheck": "vue-tsc --noEmit -p .weapp-vite/tsconfig.app.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "stylelint": "stylelint \"src/**/*.{css,scss,vue,wxss}\" --allow-empty-input",
+    "stylelint:fix": "stylelint \"src/**/*.{css,scss,vue,wxss}\" --fix --allow-empty-input",
+    "postinstall": "wv prepare -p weapp"
+  },
+  "devDependencies": {
+    "@icebreakers/eslint-config": "catalog:",
+    "@icebreakers/stylelint-config": "catalog:",
+    "@types/node": "catalog:",
+    "@weapp-vite/dashboard": "workspace:*",
+    "eslint": "catalog:",
+    "miniprogram-api-typings": "catalog:",
+    "stylelint": "catalog:",
+    "typescript": "catalog:",
+    "vue-tsc": "catalog:",
+    "weapp-vite": "workspace:*",
+    "wevu": "workspace:*"
+  }
+}

package/templates/multi-platform-sfc/src/app.vue

@@ -0,0 +1,19 @@
+<script setup lang="ts">
+defineAppJson({
+  pages: ['pages/index/index'],
+  window: {
+    navigationBarTitleText: '多平台 SFC 模板',
+    navigationBarBackgroundColor: '#ffffff',
+    navigationBarTextStyle: 'black',
+  },
+  sitemapLocation: 'sitemap.json',
+})
+</script>
+
+<style>
+page {
+  min-height: 100%;
+  color: #17212b;
+  background: #f4f6f8;
+}
+</style>

package/templates/multi-platform-sfc/src/components/PlatformCard/index.vue

@@ -0,0 +1,55 @@
+<script setup lang="ts">
+import { computed } from 'wevu'
+
+const props = defineProps<{
+  platform?: string
+}>()
+
+defineComponentJson({
+  component: true,
+})
+
+const platformLabel = computed(() => props.platform || 'unknown')
+</script>
+
+<template>
+  <view id="platform-card" class="platform-card">
+    <view class="platform-card__label">
+      当前 SFC 构建目标
+    </view>
+    <view id="component-platform" class="platform-card__value">
+      {{ platformLabel }}
+    </view>
+    <view class="platform-card__hint">
+      Page 与 Component 都由 Vue SFC 编译为目标平台产物
+    </view>
+  </view>
+</template>
+
+<style>
+.platform-card {
+  padding: 32rpx;
+  background: #fff;
+  border: 2rpx solid #d8dee4;
+  border-radius: 12rpx;
+}
+
+.platform-card__label {
+  font-size: 24rpx;
+  color: #66717d;
+}
+
+.platform-card__value {
+  margin-top: 10rpx;
+  font-size: 44rpx;
+  font-weight: 700;
+  color: #0969da;
+}
+
+.platform-card__hint {
+  margin-top: 18rpx;
+  font-size: 26rpx;
+  line-height: 1.6;
+  color: #3d4852;
+}
+</style>

package/templates/multi-platform-sfc/src/pages/index/index.vue

@@ -0,0 +1,134 @@
+<script setup lang="ts">
+import { computed, ref } from 'wevu'
+import PlatformCard from '../../components/PlatformCard/index.vue'
+
+definePageJson({
+  navigationBarTitleText: '多平台 SFC 模板',
+})
+
+const platform = import.meta.env.PLATFORM
+const status = ref('ready')
+const count = ref(0)
+const doubled = computed(() => count.value * 2)
+
+function increment() {
+  count.value += 1
+}
+</script>
+
+<template>
+  <view class="page-shell">
+    <view class="page-heading">
+      <view class="page-heading__eyebrow">
+        weapp-vite + wevu
+      </view>
+      <view class="page-heading__title">
+        Vue SFC 多平台 + Web
+      </view>
+      <view class="page-heading__description">
+        同一份 SFC 源码，按目标平台独立构建和验收。
+      </view>
+    </view>
+
+    <view id="platform-marker" class="runtime-marker">
+      MP_PLATFORM={{ platform }}
+    </view>
+    <view id="runtime-status" class="runtime-status">
+      status={{ status }}
+    </view>
+
+    <PlatformCard :platform="platform" />
+
+    <view class="counter-panel">
+      <view class="counter-panel__label">
+        SFC 响应式交互检查
+      </view>
+      <view id="counter-value" class="counter-panel__value">
+        {{ count }}
+      </view>
+      <view id="counter-doubled" class="counter-panel__doubled">
+        doubled={{ doubled }}
+      </view>
+      <button id="increment-button" class="counter-panel__button" @tap="increment">
+        增加计数
+      </button>
+    </view>
+  </view>
+</template>
+
+<style>
+.page-shell {
+  box-sizing: border-box;
+  min-height: 100vh;
+  padding: 72rpx 32rpx 48rpx;
+}
+
+.page-heading {
+  margin-bottom: 32rpx;
+}
+
+.page-heading__eyebrow {
+  font-size: 24rpx;
+  font-weight: 600;
+  color: #1a7f37;
+}
+
+.page-heading__title {
+  margin-top: 12rpx;
+  font-size: 52rpx;
+  font-weight: 700;
+  color: #17212b;
+}
+
+.page-heading__description {
+  margin-top: 16rpx;
+  font-size: 28rpx;
+  line-height: 1.6;
+  color: #57606a;
+}
+
+.runtime-marker,
+.runtime-status {
+  font-family: monospace;
+  font-size: 24rpx;
+  color: #57606a;
+}
+
+.runtime-status {
+  margin: 8rpx 0 28rpx;
+}
+
+.counter-panel {
+  padding: 32rpx;
+  margin-top: 24rpx;
+  text-align: center;
+  background: #fff;
+  border: 2rpx solid #d8dee4;
+  border-radius: 12rpx;
+}
+
+.counter-panel__label,
+.counter-panel__doubled {
+  font-size: 26rpx;
+  color: #57606a;
+}
+
+.counter-panel__value {
+  margin: 18rpx 0 8rpx;
+  font-size: 64rpx;
+  font-weight: 700;
+  color: #17212b;
+}
+
+.counter-panel__button {
+  width: 100%;
+  margin-top: 24rpx;
+  color: #fff;
+  background: #1f883d;
+  border-radius: 8rpx;
+}
+
+.counter-panel__button::after {
+  border: 0;
+}
+</style>

package/templates/multi-platform-sfc/src/sitemap.json

@@ -0,0 +1,9 @@
+{
+  "desc": "多平台 SFC 模板 sitemap",
+  "rules": [
+    {
+      "action": "allow",
+      "page": "*"
+    }
+  ]
+}

package/templates/multi-platform-sfc/stylelint.config.js

@@ -0,0 +1,5 @@
+import { icebreaker } from '@icebreakers/stylelint-config'
+
+export default icebreaker({
+  miniProgram: true,
+})

package/templates/multi-platform-sfc/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "references": [
+    {
+      "path": "./.weapp-vite/tsconfig.app.json"
+    },
+    {
+      "path": "./.weapp-vite/tsconfig.server.json"
+    },
+    {
+      "path": "./.weapp-vite/tsconfig.node.json"
+    },
+    {
+      "path": "./.weapp-vite/tsconfig.shared.json"
+    }
+  ],
+  "files": []
+}

package/templates/multi-platform-sfc/vite.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig } from 'weapp-vite'
+
+export default defineConfig({
+  weapp: {
+    srcRoot: 'src',
+    multiPlatform: {
+      enabled: true,
+      targets: ['weapp', 'alipay', 'tt', 'swan', 'jd', 'xhs'],
+    },
+    injectWeapi: {
+      enabled: true,
+      replaceWx: true,
+    },
+    web: {
+      enable: true,
+      outDir: 'dist/web',
+      pluginOptions: {
+        runtime: {
+          routing: {
+            mode: 'history',
+          },
+        },
+      },
+    },
+  },
+})