feat: 更新文档,修改互动型模板名称为 TanStack Router,并调整相关描述

This commit is contained in:
2026-02-19 19:42:01 +08:00
parent e8190fc194
commit 75434ce166
2 changed files with 17 additions and 42 deletions

View File

@@ -4,8 +4,7 @@ include:
.common_env: &common_env
env:
TO_REPO: kevisual/frontend-starter-skill
TO_URL: git.xiongxiao.me
USERNAME: root
imports:
- https://cnb.cool/kevisual/env/-/blob/main/.env.development
@@ -17,28 +16,4 @@ $:
- vscode
- docker
imports: !reference [.common_env, imports]
# 开发环境启动后会执行的任务
# stages:
# - name: pnpm install
# script: pnpm install
stages: !reference [.dev_tempalte, stages]
.common_sync_to_gitea: &common_sync_to_gitea
- <<: *common_env
services: !reference [.common_sync_to_gitea_template, services]
stages: !reference [.common_sync_to_gitea_template, stages]
.common_sync_from_gitea: &common_sync_from_gitea
- <<: *common_env
services: !reference [.common_sync_from_gitea_template, services]
stages: !reference [.common_sync_from_gitea_template, stages]
main:
web_trigger_sync_to_gitea:
- <<: *common_sync_to_gitea
web_trigger_sync_from_gitea:
- <<: *common_sync_from_gitea
api_trigger_sync_to_gitea:
- <<: *common_sync_to_gitea
api_trigger_sync_from_gitea:
- <<: *common_sync_from_gitea
stages: !reference [.dev_template, stages]

View File

@@ -13,7 +13,7 @@
## 模板类型对比
| 特性 | 展示型模板(astro) | 互动型模板(next.js) |
| 特性 | 展示型模板(astro) | 互动型模板(TanStack Router) |
|------|-----------|-----------|
| **核心定位** | 信息展示为主 | 用户交互为主 |
| **渲染模式** | 静态生成 (SSG) | 混合渲染 (SSR/SSG/ISR) |
@@ -101,7 +101,7 @@ astro-website/
---
## 互动型模板 (Next.js)
## 互动型模板 (TanStack Router)
适用于:以用户交互为主的网站,需要登录、动态内容、在线交易等功能。
@@ -116,8 +116,8 @@ astro-website/
### 核心特点
1. **企业级架构**
- App Router 路由系统
- Server Components
- TanStack Router 路由系统(基于 React Router
- 全类型安全的路由系统
- 完整的后台管理系统集成
- 多语言 i18n 支持
@@ -158,11 +158,11 @@ astro-website/
### 技术栈
```yaml
框架: Next.js 14+ (App Router)
框架: TanStack Router + React
UI 库: React / TailwindCSS / Shadcn UI
状态管理: Zustand / React Query
状态管理: Zustand / TanStack Query
表单: React Hook Form + Zod
认证: NextAuth.js / Clerk
认证: Auth.js / Clerk
CMS: Strapi / Contentful / Sanity (可选)
数据库: PostgreSQL / MySQL (可选)
部署: Vercel / AWS / Docker
@@ -171,9 +171,9 @@ CMS: Strapi / Contentful / Sanity (可选)
### 目录结构
```
nextjs-website/
interactive-website/
├── src/
│ ├── app/ # App Router 页面
│ ├── routes/ # TanStack Router 路由配置
│ ├── components/ # 可复用组件
│ ├── lib/ # 工具函数和配置
│ ├── hooks/ # 自定义 Hooks
@@ -181,7 +181,7 @@ nextjs-website/
│ ├── services/ # API 服务层
│ └── store/ # 状态管理
├── public/ # 静态资源
├── next.config.js # 配置文件
├── vite.config.ts # Vite 配置文件
└── package.json
```
@@ -219,13 +219,13 @@ packages/ui/
│ ├── 是 → 选择 Astro 展示型模板
│ └── 否 → 继续
├── 是否需要用户登录注册?
│ ├── 是 → 选择 Next.js 互动型模板
│ ├── 是 → 选择 TanStack Router 互动型模板
│ └── 否 → 继续
├── 是否需要在线交易/支付?
│ ├── 是 → 选择 Next.js 互动型模板
│ ├── 是 → 选择 TanStack Router 互动型模板
│ └── 否 → 可能只需要展示型
└── 是否需要复杂的动态交互功能?
├── 是 → 选择 Next.js 互动型模板
├── 是 → 选择 TanStack Router 互动型模板
└── 否 → 选择 Astro 展示型模板
```
@@ -250,12 +250,12 @@ npm run dev
npm run build
```
### 互动型模板 (Next.js)
### 互动型模板 (TanStack Router)
```bash
# 克隆模板
git clone https://github.com/your-org/showcase-cms
cd showcase-cms/templates/nextjs-website
cd showcase-cms/templates/interactive-website
# 安装依赖
npm install