# 架构基准参考表（快照日期: 2026-07 · G1 使用时必须联网校验刷新）

> 本表是**离线兜底基准**,不是权威答案。G1 推荐架构前应 WebSearch 对应交付形态的当年最佳实践;
> 网络不可用时才直接使用本表,且必须向用户标注"基于 2026-07 快照,建议联网复核"。

## 团队首选脚手架（preferred）

**better-t-stack**（`npx create-better-t-stack@latest`）——TS 全栈组合式脚手架,"只选需要的部分,零冗余",默认当前稳定版:

| 维度 | 可选项 |
| ---- | ---- |
| 前端 | React(TanStack/React Router) / Next.js / Nuxt / Svelte / Solid / Astro / **React Native**（native-bare / native-uniwind / native-unistyles；2026-07 实测 NativeWind 选项已被 Uniwind 取代） |
| 后端 | Hono / Express / Fastify / Elysia / Convex / 无 |
| 数据库+ORM | SQLite / PostgreSQL / MySQL / MongoDB + Drizzle / Prisma / Mongoose |
| 鉴权/支付 | better-auth / clerk;**payments: polar** |
| 附加 | Turborepo / PWA / Tauri / Biome / Husky 等 |

**G1 使用规则**：所选组件落在上表能力矩阵内时,默认推荐方案**基于 better-t-stack 一条命令生成**（组件按选型定制,如 `npx create-better-t-stack@latest my-app --template pern --auth better-auth`）;超出矩阵的场景（纯小程序、非 TS 栈、静态站等）按下方各表正常推导,不硬套。**注意**：写入 ADR 的命令必须全参数（尤其 `--package-manager`,缺了会交互式卡住）;G1 阶段验证用 `--dry-run`,实际生成留给 T-001。

## 移动 App

| 场景 | 推荐 | 脚手架 | 依据 |
| ---- | ---- | ---- | ---- |
| 大多数创业/中小团队 App | **React Native(新架构) + Expo** | `npx create-expo-app` | JS/TS 团队复用、生态最大、EAS 省 60-70% 移动 DevOps、AI 代码生成友好 |
| UI 密集/像素一致性苛刻 | Flutter(Impeller) | `flutter create` | 渲染性能上限、跨端像素一致 |
| 纯单平台且性能极致 | 原生 Swift/Kotlin | Xcode / Android Studio | 无跨端需求时最直接 |

App 配套工具链（与 Web 不同,推荐时一并写入 ADR）：UI 验收 = Maestro + 模拟器截图对比（BackstopJS/Playwright 不适用）;发布 = EAS build/submit + OTA（`eas update` 仅限 JS/资源变更）。

## Web

| 场景 | 推荐 | 脚手架 |
| ---- | ---- | ---- |
| 对外站点/要 SEO/营销页 | **Next.js**（无独立后端时 server actions 可免 API 层） | `npx create-next-app` |
| 登录后应用/后台/内部工具 | **Vite + React**(+React Router)——SPA 更简单便宜 | `npm create vite@latest` |
| 内容为主(博客/文档) | Astro | `npm create astro@latest` |
| Vue 团队 | Nuxt / Vite+Vue | `npx nuxi init` |

UI 层惯配: Tailwind CSS + shadcn/ui（React 系）。

## 后端 API

| 场景 | 推荐 | 依据 |
| ---- | ---- | ---- |
| TS 团队/边缘部署 | **Hono / Fastify** | 2026 新项目主流,轻量高性能,edge 友好 |
| Python 团队 | **FastAPI** | 类型安全+自动文档,Python 后端默认解 |
| 大型企业级 TS | NestJS | 结构化约束 |
| Go 团队 | Gin / Fiber | 高并发 |
| 快速起量/免运维 | Supabase / Firebase(BaaS) | 换开发速度,注意锁定成本 |

## 微信小程序

| 场景 | 推荐 | 脚手架 |
| ---- | ---- | ---- |
| 仅微信端 | 原生小程序 | 微信开发者工具 |
| React 团队/多端 | Taro | `taro init` |
| Vue 团队/多端 | uni-app | HBuilderX / CLI |

## 桌面

| 场景 | 推荐 |
| ---- | ---- |
| Web 团队做桌面 | Tauri（轻）/ Electron（生态大） |

## 维护规则

- 本表由 G1 联网校验结果**顺手更新**（发现快照过时 → 更新表格与快照日期,是 doc-syncer 职责的延伸）
- 表中"推荐"永远让位于 G1 的两条一票否决：团队约束、部署条件