From 75434ce166f8c77c81b3ec9bb4fec651990584bf Mon Sep 17 00:00:00 2001 From: abearxiong Date: Thu, 19 Feb 2026 19:42:01 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= =?UTF-8?q?=EF=BC=8C=E4=BF=AE=E6=94=B9=E4=BA=92=E5=8A=A8=E5=9E=8B=E6=A8=A1?= =?UTF-8?q?=E6=9D=BF=E5=90=8D=E7=A7=B0=E4=B8=BA=20TanStack=20Router?= =?UTF-8?q?=EF=BC=8C=E5=B9=B6=E8=B0=83=E6=95=B4=E7=9B=B8=E5=85=B3=E6=8F=8F?= =?UTF-8?q?=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .cnb.yml | 29 ++--------------------------- README.md | 30 +++++++++++++++--------------- 2 files changed, 17 insertions(+), 42 deletions(-) diff --git a/.cnb.yml b/.cnb.yml index 90b789b..f972dd3 100644 --- a/.cnb.yml +++ b/.cnb.yml @@ -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 \ No newline at end of file + stages: !reference [.dev_template, stages] \ No newline at end of file diff --git a/README.md b/README.md index 0cd0cba..37bf9f9 100644 --- a/README.md +++ b/README.md @@ -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