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 .common_env: &common_env
env: env:
TO_REPO: kevisual/frontend-starter-skill USERNAME: root
TO_URL: git.xiongxiao.me
imports: imports:
- https://cnb.cool/kevisual/env/-/blob/main/.env.development - https://cnb.cool/kevisual/env/-/blob/main/.env.development
@@ -17,28 +16,4 @@ $:
- vscode - vscode
- docker - docker
imports: !reference [.common_env, imports] imports: !reference [.common_env, imports]
# 开发环境启动后会执行的任务 stages: !reference [.dev_template, stages]
# 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

View File

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