feat: 更新文档,修改互动型模板名称为 TanStack Router,并调整相关描述
This commit is contained in:
29
.cnb.yml
29
.cnb.yml
@@ -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
|
|
||||||
30
README.md
30
README.md
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user